Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Updating

Garuda Nix installs the garuda-update command on GUI systems and on systems managed through garuda-managed.json. It is the a convenient way to keep the system up to date.

garuda-update

What it does

  • NixOS flake setups: updates the flake inputs, rebuilds with nh os switch, and commits the refreshed flake.lock when the flake lives in a Git repository. The flake defaults to /etc/nixos and can be pointed elsewhere with GARUDA_FLAKE.
  • Managed systems (/etc/nixos/garuda-managed.json exists): downloads the latest updater from the stable branch and runs it. This regenerates the managed configuration, updates the flake inputs and rebuilds.

Rolling back

Roll back to the previous generation (only on standalone NixOS):

garuda-update --rollback

Subsystem

On a Garuda subsystem, garuda-update runs from inside Garuda Nix with the managed path described above. The update can also be triggered from the Garuda host with sudo garuda-nix-subsystem update.