Startup failures¶
Symptoms¶
- AppHost never settles
- the API exits immediately
- readiness never becomes healthy
Likely causes¶
- .NET or Node prerequisites are missing in local environments
- PostgreSQL is not reachable
- the migrator failed before the API became ready
- ports are already in use
Checks¶
- inspect AppHost, API, and migrator logs
- verify PostgreSQL connectivity
- confirm
/healthand/alivebehavior - confirm no conflicting local ports are already bound
Fixes¶
- correct prerequisites and retry
- use
OPENIDENTITYSTACK_DISABLE_DATA_VOLUME=truefor a clean local run when state is corrupted - repair the database connection string or secret reference
- fix container startup ordering so the migrator finishes first
When to escalate¶
Escalate when startup consistently fails after database and certificate inputs are confirmed.