Local installation¶
Use this path for evaluation, development, and integration testing.
Prerequisites¶
- .NET 10 SDK
- Node.js LTS
- Git
PostgreSQL client tooling is optional but useful for diagnostics.
Run locally with Aspire¶
git clone https://github.com/Tjeerd-menno/open-identity-stack.git
cd open-identity-stack
dotnet restore OpenIdentityStack.slnx
dotnet build OpenIdentityStack.slnx --no-restore
cd src/OpenIdentityStack.AppHost
dotnet run
The AppHost composes:
- PostgreSQL
- the database migrator
- the API
- the management web app
Local runtime behavior¶
- PostgreSQL uses a persistent data volume by default
Seed__DevelopmentData=trueis set for the local migrator path- the management web receives
VITE_OIDC_AUTHORITYandVITE_API_BASE_URLfrom the API endpoint
Useful local toggles¶
Clean state between runs¶
OPENIDENTITYSTACK_DISABLE_DATA_VOLUME=true
Skip the management web¶
OPENIDENTITYSTACK_ENABLE_MANAGEMENTWEB=false
First-run checklist¶
- confirm the migrator completes
- open the management web
- confirm the API root or health endpoints respond
- sign in and verify that an admin page loads
Continue with Quick start if you want the fastest end-to-end path.