CasaOS Runit Package

Overview

This package ports CasaOS v0.4.15 to runit-based systems (Void Linux, etc.).

Features

• ✅ Native runit service scripts
• ✅ Built-in dependency management with sv check
• ✅ All 6 CasaOS microservices included
• ✅ Complete web UI (39MB)
• ✅ Auto-start on boot
• ✅ Proper service ordering

Package Files

1. casaos-runit_0.4.15.deb (56MB) - For Debian-based systems with runit
2. casaos-runit-0.4.15.tar.gz (59MB) - Universal tarball for Void Linux, etc.
3. install-runit.sh - Universal installer script (auto-detects OS)

Package Contents

• 6 runit service directories in /etc/sv/
• 6 CasaOS binaries in /usr/bin/
• Configuration files in /etc/casaos/
• Web UI in /var/lib/casaos/www/

Services Included

1. casaos-message-bus - Inter-service communication
2. casaos-gateway - API gateway and web server
3. casaos-user-service - User authentication
4. casaos-local-storage - File management
5. casaos-app-management - Docker/app management
6. casaos - Main service

Installation

Quick Install (Recommended)

# Universal installer - auto-detects your system
sudo bash install-runit.sh

Manual - Void Linux

# Extract tarball
cd / && sudo tar xzf /path/to/casaos-runit-0.4.15.tar.gz

# Enable services by linking to /var/service
sudo ln -s /etc/sv/casaos-message-bus /var/service/
sleep 1
sudo ln -s /etc/sv/casaos-gateway /var/service/
sleep 1
sudo ln -s /etc/sv/casaos-user-service /var/service/
sleep 1
sudo ln -s /etc/sv/casaos-local-storage /var/service/
sleep 1
sudo ln -s /etc/sv/casaos-app-management /var/service/
sleep 1
sudo ln -s /etc/sv/casaos-casaos /var/service/

Manual - Debian-based systems with runit

sudo dpkg -i casaos-runit_0.4.15.deb

Services auto-start after installation.

Usage

# Check service status
sudo sv status casaos-*

# Start/stop individual services
sudo sv up casaos-message-bus
sudo sv down casaos-message-bus
sudo sv restart casaos-message-bus

# Stop all CasaOS services
sudo sv down casaos-*

# Start all CasaOS services
sudo sv up casaos-*

# View service logs (if configured)
sudo svlogtail casaos-message-bus

Runit Features

• Simple run scripts with exec for process supervision
• Dependency checking with sv check
• Automatic restart on failure
• Clean process management
• Minimal overhead

Service Dependencies

Services check dependencies before starting:

1. casaos-message-bus (no dependencies)
2. casaos-gateway (requires message-bus)
3. casaos-user-service (requires gateway)
4. casaos-local-storage (requires user-service)
5. casaos-app-management (requires local-storage)
6. casaos (requires app-management)

Access

Web interface: http://localhost (or your server IP)

Compatibility

• Void Linux
• Any runit-based distribution

Differences from Other Versions

• vs systemd: Uses runit supervision instead of systemd units
• vs sysvinit: Process supervision and automatic restarts
• vs OpenRC: Simpler service files, different directory structure

Version Ported Date: 2 December 2025 Build Version: 0.4.15 License: Apache 2.0

Maintainer Information

Original Package Maintainer: CasaOS Team [email protected]

Maintainer of these ported packages: Nobody really - these are just working proof of concepts. Well, I fixed it to work on sysvinit and ported that one to the other init systems.

Initially I just wanted CasaOS to work on Devuan Linux so I could make much more efficient bootable/installable images I can restore/install to my own home computers etc.

PLEASE NOTE: From the very first moment you ponder to try these, make a backup of the OS state and take it that there's no responsibility of any description because they were just for me and I am sharing for anyone to look at.

All original coding I didn't port belongs to the copyrighted maker/creator.

P.S. IceWhale/Zema: I didn't modify any API stuff so it uses your API as it was programmed originally, so please, don't sue - I'm just tryna make the proof of concept available for others to ponder.

P.S.S. I have help in parts with Claude AI, for the tricky sections. I'm no coder but I do know my way around a penguin-based OS heh.