Skip to content

Local Kubernetes Setup (Minikube/MicroK8s)#

This guide covers setting up Flex 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/GluuFederation/flex/vreplace-flex-version/automation/startflexdemo.sh && chmod u+x startflexdemo.sh && ./startflexdemo.sh

This installs Docker, MicroK8s, Helm, and Flex 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 gluu

Next Steps#

Proceed to Ingress Setup to configure traffic routing.