Opzetten NL Portal
Wat heb je nodig
Om de NL Portal lokaal op te zetten is enige basiskennis van de CLI (command-line interface) vereist. Daarnaast heb je de volgende software nodig:
Docker Desktop — de enige harde vereiste om de NL Portal demo te draaien.
Waar kan ik de code vinden
Alle code en informatie is opensource en kan gevonden worden op github.com. De NL Portal is opgesplitst in meerdere repositories. Hieronder een korte beschrijving van elk.
Documentatie over de NL Portal
Referentie-implementatie van de NL Portal backend en frontend apps, inclusief een docker-compose demo-omgeving. Het startpunt voor een eigen portaal.
Libraries voor de frontend die gebruikt worden in de NL Portal App
Libraries voor de backend die gebruikt worden in de NL Portal App
Een docker compose setup om het ZGW landschap op te zetten
Kubernetes Helm charts voor het deployen van een NL Portal omgeving
Let op: de eerdere frontend en backend template repositories zijn vervangen door de NL Portal App repository. Gebruik deze als startpunt voor een eigen portaal.
Route 1: De prebuilt images draaien
De snelste manier om de NL Portal te bekijken is via de kant-en-klare demo-omgeving in de NL Portal App repository. De docker-compose file in deze repository bevat alles wat nodig is:
De prebuilt NL Portal backend en frontend images (
ghcr.io/nl-portal/nl-portal-app-backendenghcr.io/nl-portal/nl-portal-app-frontend).De benodigde ZGW componenten (Open Zaak, Objecten API, OpenKlant, OpenProduct) en Haal Centraal mocks, opgedeeld in docker-compose profielen zodat je zelf kiest welke onderdelen je start.
Een voorgeconfigureerde Keycloak met token exchange v1 (zie ook de Keycloak configuratie pagina).
Clone de repository en start de demo-omgeving met:
De NL Portal is daarna bereikbaar op http://localhost:3000. Je kunt inloggen met de volgende testgebruikers:
burger
burger
999993847
bedrijf
bedrijf
14127293
Let op: het opstarten van alle ZGW componenten kan enkele minuten duren. De profielen remote en local kunnen niet tegelijk draaien omdat ze dezelfde poorten gebruiken.
De volledige tabel met services, poorten en profielen vind je in de README.md van de NL Portal App repository.
Route 2: Configureren via het Configuration Panel
De aanbevolen manier om de NL Portal aan te passen is via het Configuration Panel. Hiermee kun je zonder code aan te passen:
Alle backend modules configureren (ZGW APIs, HaalCentraal, OpenKlant, etc.)
Een eigen logo uploaden
De huisstijl aanpassen via design tokens
Start het Configuration Panel mee in de demo-omgeving:
Het Configuration Panel is bereikbaar op http://localhost:3001 met gebruikersnaam admin en wachtwoord admin.
Zie de Configuration Panel pagina voor uitgebreide documentatie over het aansluiten van een bestaande NL Portal instantie.
Route 3: Fork de repository (geavanceerd)
Wil je de NL Portal uitbreiden met eigen componenten of functionaliteit die niet via configuratie mogelijk is? Fork dan de NL Portal App repository en bouw je eigen images:
Fork de repository op GitHub en clone je fork lokaal.
Pas de frontend en/of backend aan naar wens.
Bouw en start je eigen images met:
Ook nu is de NL Portal bereikbaar op http://localhost:3000 met dezelfde testgebruikers als hierboven.
Wanneer forken? Alleen nodig voor:
Eigen frontend componenten of pagina's
Eigen backend plugins of modules
Aanpassingen aan de authenticatiemethoden (zie Keycloak configuratie)
Voor configuratie van API-koppelingen en huisstijl is forken niet nodig — gebruik hiervoor het Configuration Panel.
Configuratie via environment variabelen
De NL Portal app images kunnen ook volledig geconfigureerd worden via environment variabelen. De volledige referentie met inline documentatie vind je in de NL Portal App repository, in de bestanden imports/backend.env en imports/frontend.env. Zie de Deployment guide voor de naamconventie, de module-configuratie en het deployen met Helm.
Vervolgstappen
Nu je eerste NL Portal draait kun je verder met:
Configuration Panel — configureer API-koppelingen en theming via een UI.
Eigen vormgeving — meer informatie over design tokens en huisstijl.
Deployment guide — deploy de NL Portal naar je eigen omgeving (Azure, AWS of Kubernetes).
Keycloak configuratie — sluit de NL Portal aan op je eigen Keycloak.
Last updated