Get TermuOS

Build it, boot it, poke around.

TermuOS ships as source — there's no installer. Build termuos.iso yourself in about a minute, or pull the latest image straight from continuous integration.

Recommended

Build from source

The most reliable way to get a working ISO — you're compiling against the toolchain you have, so there's nothing to mismatch.

shell

# 1. install the toolchain
sudo apt install clang nasm make xorriso qemu-system-x86

# 2. clone and build
git clone https://github.com/TermuOS-Project/TermuOS.git
cd TermuOS
make

# 3. boot it
make run

Full build docs

Alternative

CI-built ISO

Every push to main runs through GitHub Actions, which builds termuos.iso and uploads it as a workflow artifact — no local toolchain required.

Open the latest successful run under the Build TermuOS workflow and download the termuos-iso artifact.

View workflow runs

Before you build

What you'll need

Host system

A Linux machine or VM
x86_64 recommended
~500 MB free disk space

Build tools

clang
nasm
make
xorriso

To run the ISO

qemu-system-x86 (easiest)
Or: real hardware / another hypervisor
Or: a USB writer, e.g. dd

Where it runs

Boot targets

QEMU

make run boots straight into an emulated machine — the fastest way to try TermuOS.

Bare metal

Write termuos.iso to a USB drive and boot it on real x86_64 hardware via BIOS or UEFI.

Other hypervisors

Any VM that boots a standard ISO — VirtualBox, VMware, etc. — will work; QEMU is simply what the Makefile targets.

TermuOS is under active, early development — expect rough edges, and treat it as a machine for reading and experimenting with rather than daily use.

Something not building?

Open an issue with your distro, toolchain versions, and the build log — the project is actively maintained on GitHub.

Open an issue Back to docs