Skip to main content
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 for details. Extract the standalone binary archive:
Run the Orchestrator directly, specifying your configuration file:
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.
For persistent operation via launchd, set both variables in the EnvironmentVariables key of your launch daemon plist.

Installation Overview

System requirements, download options, CLI flags, and environment variables

Configuration

Configure the Orchestrator after installation

Getting Started

End-to-end quick-start guide