Files
nixos-vorlagen/docs/UPDATER_ANLEITUNG.md
T
2026-06-16 21:49:01 +02:00

2.0 KiB

NixOS Update

nixos-update ist der eingebaute Update-Helfer für dieses Repo. Er zieht zuerst den neuesten Stand aus Git und führt danach nixos-rebuild mit deiner lokalen Flake-Konfiguration aus.

Der Befehl wird über modules/updater.nix ins System installiert.

Repo im Modul setzen

Repo-Pfad und Flake-Ziel stehen direkt in modules/updater.nix. Für Freunde und für ein dauerhaftes System-Repo ist /etc/nixos der empfohlene Ort.

repo_root="/etc/nixos"
flake_target="template"

Standard

nixos-update

Das ist der normale Alltagsfall:

git pull --ff-only
sudo nixos-rebuild switch --flake /pfad/zum/repo#<flake_target>

Modi

nixos-update switch
nixos-update boot
  • switch aktiviert die neue Generation sofort. Das ist auch der Standard.
  • boot baut die neue Generation, aktiviert sie aber erst für den nächsten Neustart.

Weitere Optionen

nixos-update update-inputs
nixos-update dry-run
  • update-inputs führt vor dem Rebuild noch nix flake update aus.
  • dry-run zeigt die Schritte und Befehle an, ohne sie auszuführen.

Typische Beispiele

nixos-update
nixos-update update-inputs
nixos-update boot
nixos-update boot update-inputs
nixos-update dry-run

Hinweise

  • Das Skript nutzt git pull --ff-only. Wenn dein lokaler Branch und der Remote auseinanderlaufen, stoppt der Pull bewusst.
  • Wenn repo_root für den normalen Benutzer nicht beschreibbar ist, laufen Git- und Flake-Befehle mit sudo. Das passt besonders für /etc/nixos.
  • Vor jedem größeren Schritt zeigt das Skript den Abschnitt und den konkreten Befehl an.
  • Bei lokalen uncommitteten Änderungen erscheint vor dem Pull eine Warnung.
  • nixos-update fragt per sudo -v nach deinem Passwort, sobald es sudo wirklich braucht.
  • nixos-sync und update-nixos bleiben als Alias erhalten und rufen intern ebenfalls nixos-update auf.
  • Wenn du das Repo an einen anderen Ort legst, ändere repo_root direkt in modules/updater.nix.

Hilfe

nixos-update help