stagex/sxos
14
1
Fork
You've already forked sxos
2
A full-source-bootstrapped, deterministic, minimal, immutable, workstation linux distribution based on stagex, and designed for container-centric development.
  • Shell 45.4%
  • Dockerfile 42.9%
  • Makefile 8.3%
  • Python 3.4%
2026年03月18日 15:45:09 -07:00
src maint: stagex updates, user/group fixes, disk support 2026年03月18日 15:45:09 -07:00
.gitignore feat: sshd on boot with build-time provided credentials 2026年02月15日 23:25:24 -08:00
Containerfile maint: stagex updates, user/group fixes, disk support 2026年03月18日 15:45:09 -07:00
LICENSE.md feat: boot to working shell 2026年02月14日 13:23:43 -08:00
Makefile Fix rootfs dependencies 2026年02月17日 12:08:17 +11:00
README.md feat: boot to working shell 2026年02月14日 13:23:43 -08:00

SxOS

https://codeberg.org/stagex/sxos

About

A full-source-bootstrapped, deterministic, minimal, immutable, workstation linux distribution based on stagex, and designed for container-centric development.

Features

  • Deterministic iso generation for multi-party code->binary verification
  • Small footprint (< 100MB)
  • Immutable and Diskless base: runs from initramfs

Requirements

Software

  • docker 26+

Hardware

  • x86_64 PC or laptop
  • Blank flash drive

Build

make

Install

  1. Write sxos.iso to CD-ROM or SD Card a. dd if=out/sxos.iso of=/dev/sda bs=1M conv=sync status=progress b. cdrecord out/sxos.iso

  2. Verify media still produces expected hash

sha256sum out/sxos.iso
head -c $(stat -c '%s' sxos.iso) /dev/sda | sha256sum

Develop

Build develop image

make

Boot image in qemu

make vm

Enter shell in build environment

make shell