Lokaal installeren met Aspire

Gebruik Aspire voor ontwikkeling en een lokale proef. Aspire start de benodigde diensten en toont hun adressen; het is geen productie-installatie.

Benodigdheden

.NET SDK 10; de backendversie staat in src/backend/global.json.
Node.js 26.x, ten minste 26.10; controleer src/frontend/.nvmrc.
pnpm 12.8.1. Node 26 levert geen Corepack mee: installeer pnpm expliciet.
Een draaiende Docker-runtime voor PostgreSQL, Mailpit, opslagemulatie en bestandscontrole.
Git; voor de platformbijdrage en lokale CI ook een aangemelde GitHub CLI.

Starten

git clone https://github.com/expertslive/omnia-platform.git
cd omnia-platform
npm install --global pnpm@12.8.1
./setup.sh
dotnet run --project src/aspire/Omnia.AppHost --launch-profile http

Op Windows gebruik je ./setup.ps1. Een afzonderlijke Aspire-workload installeren is niet nodig.

Controleren of het gelukt is

Open de volledige dashboardlink uit de console; de login-token hoort bij die lokale run.
Wacht tot migrate succesvol is afgerond.
Controleer dat api, worker, web en admin draaien. Open het adres van admin vanuit Resources.
Controleer de gereedheid van de API op /health/ready. Gebruik Mailpit om lokale testberichten te bekijken.
Maak een demo-editie aan.

De frontendinstallatie loopt bij een nieuwe checkout automatisch. Iedere checkout krijgt een eigen database- en opslagvolume. Het standaard HTTP-profiel gebruikt een vaste dashboardpoort; voor gelijktijdige stacks zijn afzonderlijke poorten nodig.

Veelvoorkomende problemen

Poort bezet: stop niet zomaar een andere stack. Controleer welke run bij je checkout hoort of kies andere dashboard-, resource- en telemetriepoorten.

Dienst stopt met code 64: configuratie ontbreekt; de melding noemt wat je moet invullen. Code 75: een tijdelijke startvoorwaarde ontbreekt, bijvoorbeeld migraties.

Geen echte login: de lokale development sign-in geeft ontwikkelrechten. Dit is geen bewijs dat productie-OIDC correct is ingericht en mag niet als productielogin worden gebruikt.