TenebraOS TenebraOS

Stable Linux,
Built on Devuan

TenebraOS is systemd-free by design — runit supervises services on a Devuan Excalibur base with the KDE Plasma desktop. Featuring Btrfs snapshots, custom kernels with Apple T2 and CachyOS patches, and a unified package manager supporting APT, Flatpak, and Arch/AUR via distrobox.

Mission: a no-fuss Linux distribution — stable base, fast init, and an installer that configures the system around you, not the other way around.
Features

Why TenebraOS Is Different

Most distributions hand you a generic system and a wiki. TenebraOS builds the configuration in — init, services, drivers, and applications chosen for how you actually use the machine.

🎮

Gaming Ready

Steam, Lutris, Wine, Discord, MangoHud — everything you need pre-configured.

💻

Dev & Learning

VS Code, Python, Node.js, Jupyter, and zram out of the box for developers.

🏢

Office & Daily Use

LibreOffice, Thunderbird, and TLP power saving for productivity on the go.

🧩

Smart Installer

Calamares pipeline with GPU/T2 hardware detection and use-case selection.

⚡

systemd-free

Devuan Excalibur base with runit init — services are supervised, boot is fast.

🍎

Apple T2 Support

T2 Macs get the patched kernel (audio, keyboard, Wi-Fi) installed automatically.

🚀

Custom Kernels

BORE scheduler, BBRv3, -O3 optimization. Variants: core, T2, and full CachyOS.

💾

Btrfs Snapshots

Automatic snapper + grub-btrfs integration. Bootable snapshots from GRUB.

📦

Zebra Package Manager

Unified zbra command for native GitHub packages, APT, Flatpak, and Arch/AUR via distrobox.

🎨

KDE Plasma

Beautiful, customizable desktop with Fish shell, Kitty terminal, and custom theming.

🔧

Kernel Manager

tenebra-kernel CLI to install, swap, and remove kernel variants.

🔍

Auto Hardware Detect

First-boot detection for NVIDIA, Broadcom Wi-Fi, and Apple T2 chips.

Quick Build

From Source to ISO

Builds run in a Debian container, so any Linux host works — Arch, Fedora, anything with Docker.

  1. Install dependencies: sudo ./setup-build-deps.sh
  2. Clone the repo: git clone https://github.com/iTzR1g/TenebraOS.git
  3. Build the ISO: ./build.sh build or ./build-iso.sh (Docker)
  4. Build custom kernel: sudo ./build-tenebra-kernel.sh --variant tenebra-cachy
  5. Install Zebra: sudo ./bare/04-hybrid-pkgmanager.sh
  6. Test in QEMU: ./build.sh test-qemu
  7. Flash to USB: sudo ./build.sh flash

Ready to Try TenebraOS?

Clone it, build it, flash it — and get a desktop with Btrfs snapshots, custom kernels, and multi-package support configured before you log in.