> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strata.io/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS

The Orchestrator is distributed as platform-specific packages downloadable from the Maverics Console. To download the installer for your platform, open any Deployment in the Console and use the **Download Orchestrator Software** modal. See [Download the Orchestrator](/reference/orchestrator/installation#download-the-orchestrator) for details.

Extract the standalone binary archive:

```bash theme={null}
unzip maverics-orchestrator.zip
```

Run the Orchestrator directly, specifying your configuration file:

```bash theme={null}
./maverics -config /path/to/config.yaml
```

macOS does not have native systemd service integration. The binary runs in the foreground by default. For persistent background operation, you can manage the process with `launchd` by creating a launch daemon plist, or run it within a terminal multiplexer like `tmux` or `screen`.

## In-Place Config Reload

To enable zero-downtime config reload, set `MAVERICS_RELOAD_CONFIG=true`. On
macOS, also set `TMPDIR` to a short path such as `/tmp` — the default macOS temp
directory is a long path under `/var/folders/…/T/` that can prevent the
Orchestrator from enabling in-place reloads. You can also unset `TMPDIR`
entirely, which causes the Orchestrator to fall back to `/tmp`.

```bash theme={null}
MAVERICS_RELOAD_CONFIG=true TMPDIR=/tmp ./maverics -config /path/to/config.yaml
```

For persistent operation via launchd, set both variables in the
`EnvironmentVariables` key of your launch daemon plist.

## Related Pages

<CardGroup cols={2}>
  <Card title="Installation Overview" icon="download" href="/reference/orchestrator/installation">
    System requirements, download options, CLI flags, and environment variables
  </Card>

  <Card title="Configuration" icon="gear" href="/reference/orchestrator/configuration">
    Configure the Orchestrator after installation
  </Card>

  <Card title="Getting Started" icon="rocket" href="/introduction/getting-started">
    End-to-end quick-start guide
  </Card>
</CardGroup>