zitadel-docker

Local Zitadel dev environment for Block OS.

Brings up:

• Postgres (internal only)
• Zitadel on http://localhost:8083

First-boot seeds:

• Org BlockOS
• Human admin: admin@blockos.local / Password1!
• Machine service-account init-sa with a JWT key → ./machinekey/zitadel-init.json

Quick start

docker compose up -d
./init.sh          # seeds project + OIDC app, writes .env.zitadel

Or via mani from the workspace root:

mani run zitadel-up
mani run zitadel-init

Teardown

docker compose down -v   # wipes Postgres + machinekey volume

Or:

mani run zitadel-clean

Files

File	Purpose
docker-compose.yml	Postgres + Zitadel services
init.sh	Seeds project/OIDC app, writes .env.zitadel
machinekey/	Runtime — JWT key file (gitignored)
.env.zitadel	Runtime — client ID + issuer (gitignored, generated by init.sh)