Help Center
Pages

What are the requirements to self-host Atlas?

Topic
Self-hosting
Asked by
Infrastructure engineers
AdminUpdated Sep 11, 2026

A self-hosted Atlas deployment consists of a few services:

  • API service — the core authentication and management API.

  • Background worker — handles asynchronous jobs: webhook delivery, SCIM provisioning forwarding, data-subject-request processing, log-stream forwarding and maintenance tasks.

  • Web frontend — the admin dashboard and hosted sign-in pages.

Requirements:

  • PostgreSQL for primary storage.

  • A container runtime — Docker Compose works out of the box; any container orchestrator is fine.

  • A domain and TLS certificate for your instance's endpoints.

  • Secrets for the envelope-encryption master key and provider credentials.

Deploys do not auto-migrate — you run migrations as an explicit step during upgrades. Full environment reference and a launch runbook are in the docs.

You need a PostgreSQL database, a container runtime (Docker/Compose or a Kubernetes-style orchestrator), and a domain with TLS. Atlas runs as an API service, a background worker, and the web/hosted-page frontends.

Was this page helpful?
What are the requirements to self-host Atlas?