stagex/sxos
15
0
Fork 1
Code Issues Pull requests 1 Activity
A full-source-bootstrapped, deterministic, minimal, immutable, workstation linux distribution based on stagex, and designed for container-centric development.
10 commits 1 branch 0 tags 91 KiB
  • Dockerfile 44.4%
  • Shell 42.7%
  • Makefile 9.1%
  • Python 3.8%
Find a file
Lance R. Vick 611f090215
 Merge remote-tracking branch 'origin/refs/pull/1/head'
2026-02-19 20:16:28 -08:00
src feat: ntpd on boot 2026-02-17 01:29:03 -08:00
.gitignore feat: sshd on boot with build-time provided credentials 2026-02-15 23:25:24 -08:00
Containerfile feat: working docker on boot 2026-02-16 23:42:21 -08: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

README.md

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