Guide

Getting started

Download, flash, install, and land on a working desktop.

ShedOS ships as a single bootable ISO. Flash it to a USB stick, run the installer, and reboot into a working Hyprland desktop with your toolchain preinstalled.

1. Download

Grab the latest ISO and its SHA-256 from the download page.

2. Verify

sha256sum shedos-YYYY.MM.DD-x86_64.iso

The hash must match the one on the download page. If it doesn’t, the file is corrupted — do not boot it.

3. Flash

sudo dd if=shedos-YYYY.MM.DD-x86_64.iso of=/dev/sdX bs=4M status=progress conv=fsync

Ventoy, Rufus, and balenaEtcher also work.

4. Install

Boot the USB from your firmware’s boot menu. The installer walks you through partitioning, user creation, and locale. ShedOS defaults are pre-seeded.

5. First boot

A one-shot welcome flow collects your name, email, and GitHub username to configure git. The desktop (Hyprland, waybar, mako, kitty) is already themed and ready.

Next

  • Upgrading — how updates and dotfile merges work.
  • Commands — the full shedman CLI reference.
  • Keybindings — every shortcut the desktop ships with.