Reference

Hardware

Requirements

MinimumRecommended
CPUany x86_644+ cores
RAM6 GB usable (installer-enforced)8 GB+
Disk20 GB (installer-enforced)64 GB+ SSD, NVMe preferred
FirmwareUEFI or legacy BIOSUEFI

The installer refuses to start below the minimums rather than fail midway. Both firmwares boot from the same GPT disk layout.

WiFi and networking

The linux-firmware splits for Atheros, Realtek, Mediatek, Marvell, Broadcom, Intel and more ship in the base system — WiFi works on first boot on virtually all laptops, no wired-connection bootstrap needed. NetworkManager (with iwd) drives connections; the waybar network icon opens the TUI.

Graphics

  • AMD / Intel — first-class. Mesa drivers ship; Hyprland runs out of the box.
  • NVIDIA, Turing and newer (GTX 16xx / RTX 20xx+) — the open kernel modules install automatically and nvidia_drm.modeset=1 is set. Wayland + NVIDIA has sharper edges than AMD/Intel, but current-generation cards on the open modules work well.
  • NVIDIA, pre-Turing (GTX 10xx and older) — NVIDIA dropped these from the current driver, so the installer deliberately skips it: the desktop runs on the built-in nouveau/modesetting stack and a note in /etc/shedos/nvidia-legacy-gpu explains the AUR legacy branch (nvidia-580xx-dkms) if you want the proprietary driver.

Storage

The root filesystem is BTRFS by design — snapshots and shedman rollback depend on it, so the installer doesn't offer alternatives. Twelve subvolumes separate system, home, logs, caches and container data so snapshots stay small and rollbacks don't touch your files. LUKS2 full-disk encryption is a checkbox at install.

Laptops

TLP power management, brightness/media keys, and the 2/3/4-finger touchpad gestures work out of the box. Fingerprint readers supported by fprintd (most Goodix, Synaptics, Elan) enroll with shedman fingerprint enroll and unlock both the lock screen and the greeter.

Hibernation works on machines with a disk swap partition: pick the RAM-sized swap option in the installer and the resume configuration is wired automatically; Hibernate then appears in the power menu. Systems installed without it gain the wiring on a later update if a disk swap partition exists.

Dual-boot

The installer detects a Windows boot manager on any ESP, adds a Windows entry to the boot menu, and registers ShedOS with your firmware — both systems stay reachable.

Note Something not working on your hardware? Check GitHub issues — a report with shedman status output and your hardware model is the fastest path to a fix.