Home

NebulaOS-firmware

This is where NebulaOS actually gets built — the repo that pins exact versions of the kernel, Klipper, and GuppyScreen forks, fetches them fresh, and puts together the whole flashable image. If you want the complete OS, this is the repo you want; the other three component repos won't get you there on their own.

Branch: main. Building it is genuinely just:

git clone https://github.com/coreflake1/NebulaOS-firmware.git
cd NebulaOS-firmware
./build.sh

Related repos:

• NebulaOS — where releases actually live
• NebulaOS-kernel — Linux 6.6 fork, openke branch
• NebulaOS-klipper — Klipper runtime fork, master branch
• NebulaOS-guppyscreen — touchscreen UI fork, main branch

This is developer/advanced-testing documentation — expect SSH, root, and raw partitions, not a polished installer.

---

Where to go from here

Building

• Build From Source — the ./build.sh walkthrough
• Build Environment — what's actually in the build container
• Build Provenance — figuring out what produced a given build

Getting NebulaOS onto a real printer

• A/B Slot Model — how the stock/custom partition layout works
• Developer Install From Stock — first install
• Developer Update — updating an existing install
• Developer Recovery — what to do if something goes wrong

Reference

• Repository Map — how the five NebulaOS repos fit together

These pages are quick references — the full versions with all the detail live in this repo's own docs/ folder, which is the real source of truth if the two ever disagree.