Skip to main content
Account
Lesson 3 of 9

How to Install Zitadel with Docker Compose (Step-by-Step)

Run Zitadel locally with Docker Compose and Postgres: health checks, master key, TLS for dev, and the console on localhost:8080.

Local development setup

Learn how to build a local development setup for Zitadel with Docker Compose without breaking your quickstart with race conditions. This hands-on tutorial covers extending your Docker Compose file to run Zitadel alongside Postgres, handling service dependencies, configuring health checks, and avoiding common pitfalls. Includes master key setup, TLS configuration for development, and getting the Zitadel console running on localhost:8080. Follow along with the actual Zitadel documentation examples and learn why order matters in your compose files. Perfect for developers who want a working Zitadel setup fast without the headaches.

Loading optional course email signup. If it does not load, reload this lesson to retry. Signup requires JavaScript; all lesson content remains available without signing up.