Local Kubernetes Setup (Minikube/MicroK8s)#
This guide covers setting up Janssen on a local Kubernetes cluster for development and testing.
System Requirements#
For local deployments, minimum resources are:
- 8 GB RAM
- 4 CPU cores
- 50 GB hard-disk
Resource Breakdown by Service#
| Service | CPU | RAM | Required |
|---|---|---|---|
| Auth server | 2.5 | 2.5GB | Yes |
| FIDO2 | 0.5 | 0.5GB | No |
| SCIM | 1 | 1GB | No |
| Config job | 0.3 | 0.3GB | Yes (fresh installs) |
| Persistence job | 0.3 | 0.3GB | Yes (fresh installs) |
| Nginx | 1 | 1GB | Yes (if not using ALB/Istio) |
| Auth-key-rotation | 0.3 | 0.3GB | Strongly recommended |
| Config-API | 1 | 1GB | No |
| Casa | 0.5 | 0.5GB | No |
| Link | 0.5 | 1GB | No |
| SAML | 0.5 | 1GB | No |
Quick Start Script#
Start a fresh Ubuntu 18.04/20.04/22.04 VM with ports 443 and 80 open, then run:
sudo su -
wget https://raw.githubusercontent.com/JanssenProject/jans/replace-janssen-version/automation/startjanssendemo.sh && chmod u+x startjanssendemo.sh && ./startjanssendemo.sh
This installs Docker, MicroK8s, Helm, and Janssen with default settings.
Accessing Endpoints#
The installer adds a hosts record in the VM. To access from outside the VM, map the VM IP to your FQDN.
| Service | Endpoint |
|---|---|
| Auth server | https://FQDN/.well-known/openid-configuration |
| FIDO2 | https://FQDN/.well-known/fido2-configuration |
| SCIM | https://FQDN/.well-known/scim-configuration |
Manual Setup#
If you prefer manual setup:
Next Steps#
Proceed to Ingress Setup to configure traffic routing.
