3 Wrapper Commands
Fynn Mahringer edited this page 2026-07-28 15:01:36 +02:00

Wrapper command reference

  • hosts: list every configured host and show the detected default host.
  • docs [overview|commands|layout|host [<name>]|all]: explain the repo layout, wrapper commands, and host structure.
  • docs generate: generate Markdown pages into the local wiki checkout at /home/ftmahringer/nixos-config/wiki.
  • docs wipe: remove only the wiki files previously generated by ftnix.
  • docs pull: clone or pull the remote repository wiki into /home/ftmahringer/nixos-config/wiki.
  • docs push [commit message...]: commit local wiki changes and push them to the repository wiki remote.
  • sync: mirror the repo into the system config directory before rebuilds.
  • switch [--host <name>]: sync the repo and run a local nixos-rebuild switch.
  • remote-switch <hostname|ip>: resolve the remote target back to a known host and switch it over SSH.
  • boot [--host <name>]: build and register the next boot generation without switching now.
  • test [--host <name>]: build and activate the system temporarily for testing.
  • build [--host <name>]: build the system configuration without activating it.
  • home switch [--host <name>]: run the Home Manager switch for the selected host.
  • pull: pull the git repo with a temporary auto-stash around local changes.
  • update [input...]: run flake input updates.
  • fmt: run the repo formatter through nix fmt.
  • check: run nix flake check.
  • gc: prune older NixOS and Home Manager generations, then collect garbage.
  • stylix themes|theme|icons|fonts|cursors|emoji: inspect available theming assets or set the current host theme.
  • lock: change the synced system config directory ownership to root.
  • unlock: change the synced system config directory ownership back to the user.