ok> downloads

StarshipOS, on a machine of yours.

One image per board, straight from the release. Write it to a USB stick or an SD card, boot, and the first boot makes you Zuse, the superuser: your identity lives on the stick.

[TAG] alpha · pre-release All releases →

An alpha, honestly.

Every release is booted in QEMU on amd64, aarch64 and riscv64, passes its 538 power-on checks on each, and its proofs, before it is published. On real hardware it has not been booted yet. If you try it, tell us what happened.

✓ QEMU, three architectures
○ Real hardware: not yet
Report how it went →

The images

Pick your board.

PC

any x86-64 PC that boots UEFI from USB

A USB stick image. Its first boot makes your Zuse on the stick: no account, no password — the stick is your key.

Write it (it replaces everything on the stick):
xz -dc pc-stick.img.xz | sudo dd of=/dev/sdX bs=4M conv=fsync status=progress

or balenaEtcher, which reads the .xz as it is.

pc-stick.img.xz

Raspberry Pi 5

an SD card

Boots straight from the Pi's own firmware. Until first-boot Zuse reaches this board, it needs a Zuse identity drive made on a PC.

Write it with Raspberry Pi Imager (Use custom), or:
xz -dc raspi5.img.xz | sudo dd of=/dev/sdX bs=4M conv=fsync status=progress
raspi5.img.xz

Milk-V Mars

RISC-V, an SD card

Found by the board's own U-Boot. Until first-boot Zuse reaches this board, it needs a Zuse identity drive made on a PC.

Write it:
xz -dc MilkV.img.xz | sudo dd of=/dev/sdX bs=4M conv=fsync status=progress
MilkV.img.xz

QEMU

for developers

The ISO every release's amd64 acceptance boots, byte for byte. To boot it the way we do, see the developer guide in the repository.

The repository → StarshipOS.iso

Rather not write anything? Try it in your browser — a real machine, at its prompt in seconds.

Verify

Know it's ours.

Every file's SHA-256 is in the release's SHA256SUMS. Inside each image, every capsule the system loads is signed by StarshipOS Capsule Signing, issued by the StarshipOS Root CA, and checked at boot.

sha256sum -c SHA256SUMS --ignore-missing
StarshipOS Root CA, SHA-256
DA:A7:40:56:65:41:1A:FE:E6:08:85:3F:6E:AD:83:3A:38:30:83:E6:F0:6D:69:A6:A8:9E:92:BD:85:93:39:81 SHA256SUMS → The Root CA's certificate →

Read

The documents of this release.

The Book of Fabric, the Dictionary of v4, the book and the formal set -- built from the same tree as these images.

Documents →