Skip to content

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

Quick Start Script#

Start a fresh Ubuntu VM with ports 443 and 80 open, then run:

sudo su -
wget https://raw.githubusercontent.com/JanssenProject/jans/2.1.0/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:

  1. Install Minikube or MicroK8s
  2. Install Helm
  3. Create the namespace: 
    kubectl create namespace jans

Next Steps#

Proceed to Ingress Setup to configure traffic routing.