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.
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 -dOpen HATCH_URL in a browser. The first account you create becomes the workspace owner.
Install on Kubernetes
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_URLThe 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 useHATCH_SECRET: a random 64-character string for sessions and signingDATABASE_URL,REDIS_URL: connection strings when not using the bundled servicesAI_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.
docker compose pull && docker compose up -dRead 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.