Deploy the Gateway

Choose the method that fits your environment. All options include PostgreSQL for request logging.

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:7680, 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 7680:7680 -e MAJORDOMO_STORAGE_POSTGRES_HOST=... majordomo-gateway

Gateway on localhost:7680

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).