Skip to content

Installation [Alpha]#

Minimum Requirements#

Kubernetes cluster must have the following minimum requirements available:

CPU Unit RAM Disk Space Processor Type
1 2 GB 10 GB 64 Bit

DB-less mode(Recommended)#

To install Gluu Gateway on kuberentes, follow these steps:

  1. [Pre-requirement] Install Gluu on kubernetes if not already installed and make sure OXD server is installed by answering Y to Install Casa. Answer N to prompt Install Gluu Gateway Database mode as this option is for Database mode.

  2. Install Kong with GG plugins. The only component that must be changed inside kongs manifests is the image:tag of kong to gluufederation/gluu-gateway:4.2.0_dev. Please refer to kongs kubernetes installation for more tweaks and detail.

    • With yaml manifests

         wget && cat kong-ingress-dbless | sed -s "s@image: kong:2.0@image: gluufederation/gluu-gateway:4.1.0_dev@g" | kubectl apply -f -
    • With Helm. Please refer to kongs official chart for more options.

         helm repo add kong
         helm repo update
         # Helm 3
         helm install gg-kong kong/kong --set ingressController.installCRDs=false --set image.repository=gluufederation/gluu-gateway --set image.tag=4.2.0_dev --set --namespace=gluu-gateway


Please make sure to create a secret called kong-config in the same namespace Kong was deployed in containing the kong.yml declaration file and restart gg-kong deployment.

Head to DB-less for more information. Please note that loading kong.yml occurs automatically as the kong.yml gets pulled from secrets and loaded if changes occur to it.


   helm delete gg-kong -n gluu-gateway

DB mode#

Automatic full installation#

  1. Install Gluu with Gluu gateway on kubernetes.

       ./pygluu-kubernetes.pyz install
       # To install Gluu-Gateway only: Gluu must be already installed in the same kubernetes cluster
       ./pygluu-kubernetes.pyz install-gg-dbmode


  1. Install Gluu and Postgres run. Answer Y to prompt Install Gluu Gateway. This will install Gluu, Postgres, and setup the databases and required secrets for Gluu-Gateway and Gluu-Gateway-UI.

       ./pygluu-kubernetes.pyz helm-install
  2. Wait until Gluu is up and running. Make sure oxd server and oxauth pods are running

        kubectl -n gluu wait --for=condition=available --timeout=900s deploy/gluu-oxauth
        kubectl -n gluu wait --for=condition=available --timeout=300s deploy/gluu-oxd-server
  3. Install Gluu Gateway and Gluu Gateway UI

        ./pygluu-kubernetes.pyz helm-install-gg-dbmode


    ./pygluu-kubernetes.pyz uninstall-gg-dbmode
    # With helm
    ./pygluu-kubernetes.pyz helm-uninstall-gg-dbmode