Getting Started

To install NixOS, boot the target machine using the Minimal ISO image, e.g. on a Ventoy-based USB stick, and run disko to partition the hard-disk followed by nixos-install to install and configure NixOS, e.g.

sudo nix --experimental-features "nix-command flakes" \
 run github:nix-community/disko/latest -- \
 --mode destroy,format,mount \
 --flake gitlab:painless-software/nixos-config#example

sudo nixos-install --flake gitlab:painless-software/nixos-config#example

Note

Replace example after the hash sign by your target host name.

Manual and automatic updates

To manually update an already installed host run nixos-rebuild, e.g.

nixos-rebuild switch --sudo --flake gitlab:painless-software/nixos-config

Auto-upgrade can run this command automatically once a day when the repository configures an upgrade source. When it is configured, you can check the last run and the next scheduled time with:

systemctl status nixos-upgrade.service

systemctl status nixos-upgrade.timer

Development

See CONTRIBUTING for instructions on development and testing.