Skip to main content

Developing ZITADEL with Dev Containers

Dev containers provide a convenient way to set up a development environment for ZITADEL with all the necessary dependencies pre-configured. This allows you to start contributing or working on ZITADEL locally with minimal setup.


Setting Up Dev Container

ZITADEL provides a .devcontainer folder that configures the development environment within a container. Here's how to get started:

  1. Clone the ZITADEL repository from GitHub:
git clone
  1. Navigate to the project directory:
cd zitadel
  1. Open the project in your code editor or IDE (if using one with remote container support).
  2. Follow the instructions provided by your code editor/IDE to initiate the development container. This typically involves opening the "Command Palette" or similar functionality and searching for commands related to "Dev Containers" or "Remote Containers". The quick start guide for VS Code can found here

Note: The first time you run this command, it might take some time to download the container image.

Using Dev Container

Once the container is running, you will have a development environment set up with all the necessary dependencies pre-installed. You can then follow the instructions in the ZITADEL contribution guide to build and run ZITADEL, or develop the ZITADEL console application.