The following document will take you through the process of installing, verifying the installation, and uninstalling Gloo Portal for Istio.


For this guide, we’ll need the following:

Istio version compatibility matrix:

Gloo Portal <= 0.6.x Gloo Portal >= 0.7.0
Istio <= 1.7.x
Istio 1.8.x
Istio >= 1.9.0

Note on Istio Gateways

Gloo Portal will configure Istio to expose your APIs on one or more Gateways. When installing, you can configure which Gateways should be targeted via dedicated values in the Gloo Portal Helm chart.

By default, these values are:

  - name: istio-system/istio-ingressgateway
    - port: 80
      targetPort: 8080
    - port: 443
      targetPort: 8443

For example, the default values would work if the following resources are in place:

For the remainder of this guide, we will assume the below Istio configuration is applied to your cluster. If your setup is different, you should customize the Helm values accordingly.

kind: Gateway
    release: istio
  name: istio-ingressgateway
  namespace: istio-system
    app: istio-ingressgateway
    istio: ingressgateway
  - hosts:
    - '*'
      name: http
      number: 80
      protocol: HTTP


# This is the Kubernetes service that exposes the above Gateway
apiVersion: v1
kind: Service
  name: istio-ingressgateway
  namespace: istio-system
  externalTrafficPolicy: Cluster
  # Other ports omitted for brevity
  - name: http2
    port: 80
    protocol: TCP
    targetPort: 8080
  - name: https
    port: 443
    protocol: TCP
    targetPort: 8443
    app: istio-ingressgateway
    istio: ingressgateway
  type: LoadBalancer


To install Gloo Portal you’ll use a Helm chart. You will also need a license key to submit as part of the chart deployment. If you do not have a license key, you can request one by clicking on “Get a Demo” on our website.

First we will add the repository with the Helm chart and update the repo contents.

# Add the Helm repository for Gloo Portal
helm repo add gloo-portal
helm repo update

Then we will create the target namespace for the deployment and install Gloo Portal. Replace the LICENSE_KEY placeholder with your license key.

# Create the namespace and install the Helm chart
kubectl create namespace gloo-portal
helm install gloo-portal gloo-portal/gloo-portal -n gloo-portal --set licenseKey.value=LICENSE_HERE --set istio.enabled=true

Helm will create an installation named gloo-portal.

NAME: gloo-portal
NAMESPACE: gloo-portal
STATUS: deployed

Verify your Installation

To verify that your installation was successful, check that the Gloo Portal deployments and services have been created. If you choose to install into a namespace other than gloo-portal, you will need to query your chosen namespace instead.

kubectl get all -n gloo-portal
NAME                                            READY   STATUS             RESTARTS   AGE
pod/ext-auth-service-847c77dff6-ldt56           1/1     Running            0          5m
pod/gloo-portal-admin-server-676c656bd8-tcwkm   3/3     Running            0          5m
pod/gloo-portal-controller-f646b5f4b-hb7dd      1/1     Running            0          5m
pod/rate-limiter-f5d95bf8b-tshf2                1/1     Running            0          5m
pod/redis-799fc7c785-dgfrn                      1/1     Running            0          5m

NAME                               TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                      AGE
service/ext-auth-service           ClusterIP            8083/TCP,9091/TCP,8082/TCP   5m
service/gloo-portal                ClusterIP           8080/TCP                     5m
service/gloo-portal-admin-server   ClusterIP           8080/TCP                     5m
service/rate-limiter               ClusterIP           8083/TCP,8084/TCP,9091/TCP   5m
service/redis                      ClusterIP            6379/TCP                     5m

NAME                                       READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/ext-auth-service           1/1     1            1           5m
deployment.apps/gloo-portal-admin-server   1/1     1            1           5m
deployment.apps/gloo-portal-controller     1/1     1            1           5m
deployment.apps/rate-limiter               1/1     1            1           5m
deployment.apps/redis                      1/1     1            1           5m

NAME                                                  DESIRED   CURRENT   READY   AGE
replicaset.apps/ext-auth-service-847c77dff6           1         1         1       5m
replicaset.apps/gloo-portal-admin-server-676c656bd8   1         1         1       5m
replicaset.apps/gloo-portal-controller-f646b5f4b      1         1         1       5m
replicaset.apps/rate-limiter-f5d95bf8b                1         1         1       5m
replicaset.apps/redis-799fc7c785                      1         1         1       5m

Please refer to the Architecture page for more details about what function each deployment serves.


To uninstall Gloo Portal simply run the following command:

helm uninstall gloo-portal -n gloo-portal

Next Steps

After installing the product, you may want to walk through the Concepts and Getting Started guides.