Skip to main content

data-layer/postgres

What is this​

Central PostgreSQL instance used as the canonical relational datastore for multiple services (ThingsBoard, Zitadel, Chatwoot, n8n, chat services, etc.).

Features​

  • Multiple isolated databases on a single instance
  • Optional first-start initialization (databases/users)
  • Health checks

Quick start​

./infra.sh db up
./infra.sh db status

Service-local commands (optional)​

If you need direct control while developing/debugging:

cd data-layer/postgres
./run.sh status
./run.sh logs
./run.sh psql

Minimal configuration​

  • Canonical env: .env and deployment/topology.env (generated)
  • Service overrides: data-layer/postgres/.env (generated)

Connection strings​

From containers on the shared Docker network:

postgresql://<user>:<pass>@postgres-central:5432/<db>

Full documentation​