Linux · Zig · Containers

Bare Metal.
Pure OS.

A minimal Linux distribution built from scratch with a Zig userland. No systemd. No bloat. Just the bare essentials to run containers on metal.

Read the Docs View Source

// philosophy

Stripped to the Bone

Every byte justified. Every process accounted for. StyxOS carries only what you need to cross the river.

Zig Userland

Init, shell, DNS, monitoring — all written in Zig. Static binaries. No libc dependency. Comptime safety.

Minimal Attack Surface

No package manager. No unnecessary services. If it's not in the spec, it's not on the system.

Container Native

Built to host OCI containers via crun. That's the job. Nothing more.

Linux Kernel

Proven, stable, upstream Linux. No custom forks. No patches. Just config.

Zish Shell

A modern shell with SQLite persistence, tab completion, and cross-platform support.

Built-in DNS

Lightweight DNS resolver as part of the base system. No external resolvers needed.


// architecture

The Stack

Four layers. One purpose.

Containers crun · OCI Your workloads live here
Userland zish · init · dns · sysmon All Zig. All static.
Kernel Linux 6.x Upstream. Minimal config.
Hardware x86_64 · aarch64 Bare metal. Qemu Hypervisor.

Cross the River

StyxOS is under active development. Contributions welcome.

Get Started GitHub