Install the Skupper controller¶

If you are using Skupper on local systems (Podman, Docker, Linux), you must install the CLI.

Before you can create a site on Kubernetes, you must install the Skupper controller. You can install the controller using the following methods:

Directly using YAML
Helm charts
Operator

After installing the Skupper controller, you can create sites using the CLI or YAML:

NOTE: If you install the controller scoped to cluster, you can create sites in any namespace. If you scope the controller to a namespace, you can only create sites in that namespace.

Install the Skupper controller using YAML¶

Install the Skupper controller on Kubernetes directly from the published YAML manifests.

Prerequisites

cluster-admin access to cluster

Procedure

Install a cluster-scoped controller using the following commands:

kubectl apply -f https://github.com/skupperproject/skupper/releases/download/2.1.1/skupper-cluster-scope.yaml

Install a namespace-scoped controller using the following commands:

kubectl apply -f https://github.com/skupperproject/skupper/releases/download/2.1.1/skupper-namespace-scope.yaml

Install the Skupper controller using Helm charts¶

Install the Skupper controller on Kubernetes by using the published Helm chart.

Prerequisites

cluster-admin access to cluster
helm (See https://helm.sh/docs/intro/install/)

Procedure

Run the following command to install a cluster-scoped controller:

helm install skupper oci://quay.io/skupper/helm/skupper --version 2.1.1

To install a namespace-scoped controller, add the --set scope=namespace option.