Self-hosted

Run the gateway in your own infrastructure

Choose the method that fits your environment. All options include PostgreSQL for request logging. Prefer not to run it yourself? Request early access to Majordomo Cloud — no deployment required.

Docker Compose

Quickest

Starts the gateway and PostgreSQL with a single command. Best for local development and quick evaluation.

Prerequisites

  • Docker
  • Docker Compose v2
cp .env.example .envmake compose-up

Gateway on localhost:6560, Postgres on 5432

Full guide →

Kubernetes

Production

Raw manifests with Kustomize. Deploys a 2-replica gateway and a single-node Postgres StatefulSet into a dedicated namespace.

Prerequisites

  • Kubernetes cluster (v1.25+)
  • kubectl
vi k8s/secret.yaml # set real passwordskubectl apply -k k8s/

Namespace majordomo with gateway + postgres

Full guide →

Docker (standalone)

BYO Postgres

Run the gateway container against an existing PostgreSQL instance. Build the image and pass connection details as environment variables.

Prerequisites

  • Docker
  • Existing PostgreSQL
docker build -t majordomo-gateway .docker run -p 6560:6560 -e MAJORDOMO_STORAGE_POSTGRES_HOST=... majordomo-gateway

Gateway on localhost:6560

Full guide →

Health endpoints

Every deployment method supports the same health probes. GET /health for liveness and GET /readyz for readiness (pings PostgreSQL with a 3s timeout).