Skip to content

nix

Build, test, dry-run, or activate the configured Nix profile.

Updated View as Markdown

nix is available on macOS and Linux. It operates on the selected config.toml profile. A bare nix command lists actions without running one. Successful actions publish related Nix lock state unless --no-push is set.

build

Builds the configured system without activating it. On Linux, builds the Home Manager activation package; on macOS, builds the nix-darwin system.

switch

Builds and activates the selected Home Manager profile on Linux or nix-darwin system on macOS.

test

Test-builds the configured system without activating it.

dry-run

Runs the Nix dry-run build without activating the configured system.

Options

Option Availability Description
--profile <profile> macOS, Linux Override the platform profile selected in config.toml.
--no-refresh macOS, Linux Use the local source without fetching remote changes.
--no-push macOS, Linux Keep successful Nix lock changes local.
--if-configured Linux Skip when the selected profile declares no Nix flake.
Navigation

Type to search…

↑↓ navigate↵ selectEsc close