---
title: "nix"
description: "Build, test, dry-run, or activate the configured Nix profile."
---

> Documentation Index
> Fetch the complete documentation index at: https://outfitting.jfa.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# nix

`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. |

Source: https://outfitting.jfa.dev/docs/cli/nix/index.mdx