Skip to main content
The Orchestrator is available as a pre-built container image downloaded from the Maverics Console. You download the image as a .tar archive and load it into your local Docker image store with docker load. This approach works well for development, testing, and production environments where container orchestration is managed outside of Kubernetes.

​
Load the Container Image

The Console provides a pre-built container image as a .tar archive (maverics-orchestrator.tar). Download it from the Download Orchestrator Software modal inside any Deployment in the Console. Load the image into your local Docker image store: 
docker load -i maverics-orchestrator.tar
After loading, the image is available as maverics-orchestrator. Confirm the image was loaded successfully: 
docker images | grep maverics
Optionally, tag the image for organizational naming or version tracking: 
docker tag maverics-orchestrator:latest my-registry.example.com/maverics-orchestrator:v2026.02.1

​
Run the Container

Start the Orchestrator container with port mappings for HTTP traffic and TLS, volume mounts for configuration and certificates, and any required environment variables: 
docker run -d \
  --name maverics \
  -p 8080:8080 \
  -p 9443:9443 \
  -v /path/to/config:/etc/maverics \
  -v /path/to/certs:/etc/maverics/certs \
  -e MAVERICS_HTTP_ADDRESS=":8080" \
  maverics-orchestrator
  • -p 8080:8080 — HTTP traffic port
  • -p 9443:9443 — HTTPS/TLS traffic port (health endpoint default)
  • -v — Mounts for configuration and TLS certificates
  • -e — Environment variables for runtime configuration

​
Volume Mounts

The following volume mounts are recommended for production deployments:
Host PathContainer PathPurpose
/path/to/config/etc/mavericsOrchestrator YAML configuration files
/path/to/certs/etc/maverics/certsTLS certificates and private keys
/path/to/logs/var/log/mavericsLog output directory (if file-based logging is configured)
Mount configuration and certificate directories as read-only where possible to follow the principle of least privilege: 
-v /path/to/config:/etc/maverics:ro \
-v /path/to/certs:/etc/maverics/certs:ro

​
Environment Variables

Environment variables can be passed to the container individually with -e flags or in bulk using an environment file: 
# Individual variables
docker run -e MAVERICS_HTTP_ADDRESS=":8080" -e MAVERICS_DEBUG_MODE="true" ...

# Environment file
docker run --env-file ./maverics.env ...
See Environment Variables for the complete list of supported variables.

​
Docker Compose Example

A docker-compose.yml for running the Orchestrator with persistent configuration and TLS: 
services:
  maverics:
    image: maverics-orchestrator:latest
    container_name: maverics-orchestrator
    ports:
      - "8080:8080"
      - "9443:9443"
    volumes:
      - ./config:/etc/maverics:ro
      - ./certs:/etc/maverics/certs:ro
    environment:
      - MAVERICS_HTTP_ADDRESS=:8080
    restart: unless-stopped
Start the service: 
docker compose up -d
Verify the Orchestrator is running: 
curl -s https://localhost:9443/status
# Expected: {"status": "up"}

​
Stable Deployment Identity

The Orchestrator includes a soid field in every log entry for identifying and correlating logs by instance. By default, each container receives a unique soid because containers have ephemeral machine identities — this is the expected behavior for horizontally scaled deployments where each container is a distinct instance. For singleton deployment scenarios where you want the same soid to persist across container restarts (for example, a single Orchestrator container that gets recreated during updates), mount a stable /etc/machine-id file into the container: 
docker run -d \
  --name maverics \
  -v /etc/machine-id:/etc/machine-id:ro \
  -v /path/to/config:/etc/maverics:ro \
  -p 8080:8080 \
  -p 9443:9443 \
  maverics-orchestrator
Or in Docker Compose: 
services:
  maverics:
    image: maverics-orchestrator:latest
    volumes:
      - /etc/machine-id:/etc/machine-id:ro
      - ./config:/etc/maverics:ro
      - ./certs:/etc/maverics/certs:ro
See Logging — Deployment Correlation for more on how the soid field is used.

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