Home

NebulaOS

Role in NebulaOS: End-user release repository. Holds production firmware images, checksums, release notes, and install/update instructions once releases exist — it is not a development source tree and never gains its own copy of kernel/Klipper/GUI source.

Canonical branch: main

Complete OS build: No — this repo only ever holds release artifacts. The complete build lives in NebulaOS-firmware.

Related repos:

• NebulaOS-firmware — integration/build authority, canonical operational docs
• NebulaOS-kernel — Linux 6.6 fork, openke branch
• NebulaOS-klipper — Klipper runtime fork, master branch
• NebulaOS-guppyscreen — touchscreen UI fork, main branch

Audience: Developers and advanced testers. No official consumer release has been cut from this repo yet — see Release Provenance.

---

Navigation

• Architecture — how the five repos fit together
• Developer Build — how a release artifact here is actually produced
• Developer Installation — putting a build on real hardware
• Update & Rollback — component vs. whole-image updates, and the automatic safety net
• Recovery — the recovery ladder if something goes wrong
• Release Provenance — verifying what a release actually is
• Repository Map — the five-repo relationship in full

Every page here summarizes and links back to NebulaOS-firmware's tracked docs, which remain the canonical, versioned source of truth — this wiki is navigation, not a second copy.