---
title: "init"
description: "Prepare local state and validate the selected source."
---

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

# init

**Syntax:** `outfitting-manager init [flags]`

`init` prepares runtime state and validates the selected source. It refreshes a configured remote source by default. It does not install, upgrade, remove, or activate packages.

| Option | Description |
| --- | --- |
| `--machine-id <id>` | Override the machine ID. The default is derived from user, architecture, and OS. |
| `--repo <path>` | Override the local source path for this invocation. |
| `--profile <profile>` | Select the platform profile; Windows accepts a comma-separated list. Defaults to the configured selection. |
| `--no-refresh` | Validate and use the existing source snapshot without refreshing it. |

## Platform behavior

| Platform | State prepared |
| --- | --- |
| macOS | State root and selected source; no Nix activation or Homebrew changes. |
| Linux | State root and selected source; no native package or Home Manager changes. |
| Windows | State root and selected source. |

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