Theseus init
A Linux service supervisor written in Nelua. CUE describes services and their dependencies. Theseus starts them in order and waits for their readiness checks.
Time to a working serial shell
Theseus Init is a related project outside Nelua core. In the Cascadia Core developer image it starts the Nebox console. On 21 November 2026, five alternating pairs of QEMU software-emulated boots took a median 9.51 s from launch to a successful shell command with the gzip release image. Encoding the same cpio bytes with legacy LZ4 reduced the median to 7.24 s.
The gzip runs ranged from 8.67 to 10.58 s, and LZ4 ranged from 6.76 to 8.17 s. An independent paired control booted directly to the shell in 8.47 s with gzip, versus 9.34 s with the full service graph. Compression accounted for the larger measured difference.
Boot samplesBoot commands and timing harness
Supervise services
The userspace daemon runs foreground services and native targets. It tracks child processes with Linux pidfds, reaps adopted children, and applies each service’s restart policy. The OpenRC adapter runs installed Alpine service scripts through the system OpenRC runtime.
theseusd --target TARGET
the status of openrc postgresqlBoot and rescue
Theseus has an opt-in native PID 1 for isolated Linux VM testing. It starts the supervisor and opens a console rescue shell if boot fails.
The Theseus-enabled Nebox build also provides an initramfs entry point. It mounts procfs and sysfs, starts an interactive shell on the boot console, and restarts the shell when it exits.
Boot Nebox in your browser
Start a Linux VM with Theseus as PID 1. The guest runs locally in your browser and has no network connection.
Starting the VM downloads about 30 MB. Wait for the shell prompt to appear.
Emulation by QEMU Wasm. Demo sources and licenses
Working with mounts
In the Nebox guest, use mount to attach filesystems and umount to detach them. The following example creates a temporary filesystem at the existing /mnt directory in the boot image.
/bin/nebox mount -o size=16m,mode=0755 tmpfs /mnt
/bin/nebox mount -t tmpfs
/bin/nebox umount /mntUse /bin/nebox mount TARGET to look up a configured target in /etc/fstab. /bin/nebox mount -T FILE TARGET selects another table.