Standalone Operator Install

This guide installs Istio using the standalone Istio operator. The only dependencies required are a supported Kubernetes cluster, the kubectl and the istioctl command at the release version.

To install Istio for production use, we recommend installing with istioctl instead.


  1. Perform any necessary platform-specific setup.

  2. Check the Requirements for Pods and Services.

  3. Install the istioctl command.

  4. Deploy the Istio operator:

    $ istioctl operator init

    This command runs the operator by creating the following resources in the istio-operator namespace:

    • The operator custom resource definition
    • The operator controller deployment
    • A service to access operator metrics
    • Necessary Istio operator RBAC rules

    See the available istioctl operator init flags to control which namespaces the controller and Istio are installed into and the installed Istio image sources and versions.


To install the Istio demo configuration profile using the operator, run the following command:

$ kubectl create ns istio-system
$ kubectl apply -f - <<EOF
kind: IstioOperator
  namespace: istio-system
  name: example-istiocontrolplane
  profile: demo

The controller will detect the IstioOperator resource and then install the Istio components corresponding to the specified (demo) configuration.

You can confirm the Istio control plane services have been deployed with the following commands:

$ kubectl get svc -n istio-system
NAME                                    READY   STATUS    RESTARTS   AGE
NAME                        TYPE           CLUSTER-IP      EXTERNAL-IP    PORT(S)                                                                                                                      AGE
grafana                     ClusterIP   <none>         3000/TCP                                                                                                                     64m
istio-egressgateway         ClusterIP   <none>         80/TCP,443/TCP,15443/TCP                                                                                                     64m
istio-ingressgateway        LoadBalancer   15020:31649/TCP,80:30012/TCP,443:31723/TCP,15029:31857/TCP,15030:31621/TCP,15031:31290/TCP,15032:30334/TCP,15443:31754/TCP   64m
istio-pilot                 ClusterIP   <none>         15010/TCP,15011/TCP,15012/TCP,8080/TCP,15014/TCP,443/TCP                                                                     64m
istiod                      ClusterIP     <none>         15012/TCP,443/TCP                                                                                                            64m
jaeger-agent                ClusterIP      None            <none>         5775/UDP,6831/UDP,6832/UDP                                                                                                   64m
jaeger-collector            ClusterIP   <none>         14267/TCP,14268/TCP,14250/TCP                                                                                                64m
jaeger-collector-headless   ClusterIP      None            <none>         14250/TCP                                                                                                                    64m
jaeger-query                ClusterIP   <none>         16686/TCP                                                                                                                    64m
kiali                       ClusterIP   <none>         20001/TCP                                                                                                                    64m
prometheus                  ClusterIP    <none>         9090/TCP                                                                                                                     64m
tracing                     ClusterIP    <none>         80/TCP                                                                                                                       64m
zipkin                      ClusterIP   <none>         9411/TCP                                                                                                                     64m                                                                                                         2m
$ kubectl get pods -n istio-system
NAME                                    READY   STATUS    RESTARTS   AGE
grafana-78bc994d79-gwkfd                1/1     Running   0          63m
istio-egressgateway-5fc6f84745-8f98z    1/1     Running   0          63m
istio-ingressgateway-5b89fc6c98-vkwb5   1/1     Running   0          63m
istio-tracing-c7b59f68f-dgqb8           1/1     Running   0          63m
istiod-5448f74684-gmd5w                 1/1     Running   0          52m
kiali-fb5f485fb-2l4r6                   1/1     Running   0          63m
prometheus-7b8875c479-7zsnf             1/1     Running   0          63m


Now, with the controller running, you can change the Istio configuration by editing or replacing the IstioOperator resource. The controller will detect the change and respond by updating the Istio installation correspondingly.

For example, you can switch the installation to the default profile with the following command:

$ kubectl apply -f - <<EOF
kind: IstioOperator
  namespace: istio-system
  name: example-istiocontrolplane
  profile: default

You can also enable or disable components and modify resource settings. For example, to enable the Grafana component and increase pilot memory requests:

$ kubectl apply -f - <<EOF
kind: IstioOperator
  namespace: istio-system
  name: example-istiocontrolplane
  profile: default
            memory: 3072Mi
      enabled: true

You can observe the changes that the controller makes in the cluster in response to IstioOperator CR updates by checking the operator controller logs:

$ kubectl logs -f -n istio-operator $(kubectl get pods -n istio-operator -lname=istio-operator -o jsonpath='{.items[0]}')

Refer to the IstioOperator API for the complete set of configuration settings.


Delete the Istio deployment:

$ kubectl delete -n istio-system example-istiocontrolplane

Wait until Istio is uninstalled - this may take some time. Delete the Istio operator:

$ istioctl operator remove


$ kubectl delete ns istio-operator --grace-period=0 --force

Note that deleting the operator before Istio is fully removed may result in leftover Istio resources. To clean up anything not removed by the operator:

$ istioctl manifest generate | kubectl delete -f -
$ kubectl delete ns istio-system --grace-period=0 --force
Was this information useful?
Do you have any suggestions for improvement?

Thanks for your feedback!