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.

Linux

Red Hat / RHEL

Install the RPM package on Red Hat Enterprise Linux and compatible distributions (CentOS, Rocky Linux, AlmaLinux):
sudo rpm -i maverics-rhlinux.rpm
This installs the Orchestrator binary to /usr/bin/maverics and creates a systemd service unit. Start the service and enable it to run on boot:
sudo systemctl enable --now maverics
The default configuration file path is /etc/maverics/maverics.yaml. Place your configuration file at this path before starting the service, or update the service unit to point to a different location.

Ubuntu / Debian

Install the DEB package on Ubuntu, Debian, and compatible distributions:
sudo dpkg -i maverics-package.deb
This installs the Orchestrator binary and creates a systemd service unit. Start the service and enable it to run on boot:
sudo systemctl enable --now maverics
The default configuration file path is /etc/maverics/maverics.yaml. Check the service status with:
sudo systemctl status maverics

macOS

Extract the standalone binary archive:
unzip maverics-orchestrator.zip
Run the Orchestrator directly, specifying your configuration file:
./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.

Windows

Run the MSI installer (maverics-orchestrator.msi), which provides a guided setup wizard. The installer prompts you to configure:
  • Configuration source — Path to your YAML configuration file or a remote config source URL
  • TLS certificates — Paths to your certificate and private key files
  • Environment variables — Any runtime environment variables the Orchestrator needs
The installer registers the Orchestrator as a Windows service that starts automatically on boot. Manage the service from the command line:
# Check service status
sc query maverics

# Start the service
sc start maverics

# Stop the service
sc stop maverics
Configuration is set during MSI installation and can be updated through the Windows Services management console (services.msc) or by modifying the service registry entries.