Self-hosting.

Run Hatch on your own servers

One container, Postgres and Redis. Free under AGPL-3.0, with every feature included.

Requirements

  • A Linux server with 2 vCPU and 4 GB RAM (handles around 50,000 tickets a month)
  • Docker 24+ and Docker Compose, or Kubernetes 1.28+ with Helm
  • Postgres 15+ and Redis 7+ (bundled in the Compose file, or bring managed ones)
  • A domain with a TLS certificate, and an SMTP or IMAP mailbox for email

Install with Docker Compose

The fastest path for a single server. This starts Hatch, Postgres, Redis and a worker.

Terminal
curl -fsSL https://hatch.dev/install/compose.yml -o compose.yml
curl -fsSL https://hatch.dev/install/.env.example -o .env
# set HATCH_URL, HATCH_SECRET and your mail settings in .env
docker compose up -d

Open HATCH_URL in a browser. The first account you create becomes the workspace owner.

Install on Kubernetes

Terminal
helm repo add hatch https://charts.hatch.dev
helm install hatch hatch/hatch \
  --set url=https://support.example.com \
  --set postgres.external.url=$DATABASE_URL \
  --set redis.external.url=$REDIS_URL

The chart runs the web app and workers as separate deployments, so you can scale workers on their own when automations get busy.

Configuration

Environment variables

  • HATCH_URL: the public URL agents use
  • HATCH_SECRET: a random 64-character string for sessions and signing
  • DATABASE_URL, REDIS_URL: connection strings when not using the bundled services
  • AI_PROVIDER, AI_API_KEY: optional, for AI drafts with your own model

Single sign-on

SAML and OIDC work on self-hosted installs at no cost. Add your identity provider under Settings → Security.

Upgrades

Hatch releases every two weeks. Migrations run automatically on start and are always backwards compatible within a major version.

Terminal
docker compose pull && docker compose up -d

Read the changelog before a major version upgrade. Breaking changes are listed with a migration note at the top of each release.

Backups

All state lives in Postgres and the attachments bucket. Back up both. The built-in hatch backup command writes a consistent snapshot of the database and attachments to any S3-compatible store on a schedule.

Getting help

Ask on Discord or open an issue on GitHub. If you need guaranteed response times or someone to run it for you, see hosting partners or talk to us.