Nelua

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.

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 postgresql

Boot 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 /mnt

Use /bin/nebox mount TARGET to look up a configured target in /etc/fstab. /bin/nebox mount -T FILE TARGET selects another table.