v2026.07.03Stable

The operating system for software developers.

ShedOS comes with your editors, language runtimes, containers, and a tiling desktop already configured. The changes you make are preserved across updates, every upgrade can be rolled back, and a boot that fails recovers to the last working snapshot on its own.

ada@shed — shedman
~ shedman update :: Synchronizing package databases… :: 23 packages to upgrade (pacman 18 · yay 5) :: snapshot #143 created — pre-upgrade ==> proceed? [Y/n] y hyprland 0.50.0 mesa 25.0.2 firefox 139.0 ✓ ShedOS updated. roll back any time: shedman rollback 143
The ShedOS desktop: a tiling Hyprland session with waybar, a dock, and a themed wallpaper.

A tiling Hyprland desktop — themed, and ready on first boot.

Features

Built for software development.

Configured and ready from the first boot — and engineered so you can change anything and recover from everything.

01

Non-destructive updates

When an update changes a config file you've edited, ShedOS keeps your version rather than overwriting it, and opens a three-way merge so you decide what stays.

02

Reversible upgrades

Every upgrade is a Btrfs snapshot, so an unwanted one is a single shedman rollback away. A system that fails to reach the desktop three times in a row boots the last working snapshot on its own.

03

Declarative configuration

Services, the firewall, kernel parameters, users, and the theme are described in /etc/shedos/system.toml. shedman apply brings the machine in line with it; shedman doctor reports anything that has drifted.

04

One command-line tool

Updates, rollbacks, theming, health checks, fingerprint enrollment, and per-project databases are all shedman subcommands, each with its own manual page.

The shedman config review tool showing a three-way merge of a configuration file.
Config conflicts

Three-way merge for config conflicts

When your edits and an upstream change touch the same file, ShedOS shows both and lets you merge them hunk by hunk, instead of choosing one version wholesale.

system.toml open in an editor, declaring system services and settings.
Declarative

The system in one file

/etc/shedos/system.toml describes services, the firewall, kernel options, users, and the theme. Run shedman apply and the machine matches what it says.

A ShedOS terminal running the shedman CLI alongside an editor.
First boot

A configured environment

Editors, language runtimes, and containers are installed and configured before your first login. The first git clone of your day is the first command that isn't already done.

System

Release model
Rolling (x86_64)
Compositor
Hyprland (Wayland)
Shell
Zsh + Oh My Zsh
Filesystem
BTRFS with snapshots
Encryption
LUKS2, on by default
Secure Boot
Your own keys (opt-in)
Passwordless unlock
TPM2 (opt-in)

Developer tools

Editors
Neovim (LazyVim), VS Code
Runtimes
Python, Node, Go, Rust, C++
Containers
Docker, kubectl, minikube, helm
Terminal
kitty
Browser
Firefox
Try ShedOS

Download v2026.05.17, write it to a USB, boot.

A full live desktop runs from the stick — the real Hyprland setup and toolchain. The installer is one click whenever you're convinced.