Installing operators on AKS

To install operators on Azure Kubernetes Service ( AKS ), provide access to the Helm chart on your local machine, then follow the instructions for the operators that you intend to use.

Providing access to the Helm chart

Your local machine needs to have access to the Helm chart for the IBM Cloud Pak for Integration operator so that you can install the operator on AKS . The Helm chart is available as an archive file in the IBM Charts Helm Repository on GitHub. To access the Helm chart, use either of the following methods.

Use the IBM Helm chart repository

If you have already added the IBM Helm chart to your local repository, run the following command to update it:
```
helm repo update ibm-helm
```
If you have not already added the IBM Helm chart to your local repository, run the following command:
```
helm repo add ibm-helm https://raw.githubusercontent.com/IBM/charts/master/repo/ibm-helm
```

Download the Helm chart

Go to the IBM Github repo for Helm charts.
Locate the Helm chart archive that has a name beginning with ibm-integration, for example, ibm-integration-8.1.1.tgz.
Download to your local machine.

Install the IBM Cloud Pak for Integration operator

To install the IBM Cloud Pak for Integration operator by using the Helm chart, complete the following steps.

You need to have a namespace that the IBM Cloud Pak for Integration operator and the Helm chart can be deployed into (when you install the Helm chart in step 3). You can skip this step if you have an existing namespace that you want to use (you cannot use any of the initial or system namespaces). If you do not have an existing namespace, create one now.

For example:
```
kubectl create namespace integration
```
Important: Use the same namespace for all the operators in Cloud Pak for Integration that you install.
Run the following command to either specify the namespace that you created in the previous step, or specify an existing namespace that you want to use. In the following example, integration is the namespace name.
```
kubectl config set-context --current --namespace=integration
```
Install the operator by running one of the following commands, depending on which installation mode you want to use (and how you accessed the Helm chart in the previous section). For more information on installation modes, see Installing the operators.

All namespaces on the cluster mode
- IBM Helm chart repository:
```
helm install ibm-integration ibm-helm/ibm-integration --set operator.installMode="AllNamespaces"
```
- Downloaded Helm chart:
```
helm install ibm-integration --set operator.installMode="AllNamespaces" ./ibm-integration-<version info>.tgz
```
A single namespace on the cluster mode
- IBM Helm chart repository:
```
helm install ibm-integration ibm-helm/ibm-integration
```
- Downloaded Helm chart:
```
helm install ibm-integration ./ibm-integration-<version info>.tgz
```

Run the following command to verify the status of the operator:

helm ls

You should get a response that is similar to this example output:

NAME                 NAMESPACE        REVISION      UPDATED                                   STATUS        CHART                      APP VERSION
ibm-integration      integration      1             2026-06-03 14:12:30.225442 +0100 BST      deployed      ibm-integration-8.3.0      16.2.0.0

To uninstall the operator, run the following command:
```
helm uninstall ibm-integration
```

Additional configuration parameters

You can use the --set flag to override the default chart values when running the helm install command in step 3.

Key	Type	Default	Description
operator.installMode	string	`"OwnNamespace"`	Installation mode for the operator (`OwnNamespace` or `AllNamespaces`). For more information, see Installing the operators.
operator.deployment.resources	object	`{"limits":{"cpu":"200m","memory":"1Gi"},"requests":{"cpu":"200m","memory":"1Hi"}}`	Resources to apply to the operator pod
operator.privateRegistry	string	`""`	Private registry override to allow users to pull from alternative private registries

Installing the product operators

After you install the IBM Cloud Pak for Integration operator, you can install other product operators. For instructions on installing other operators on AKS , see the applicable product documentation:

What to do next

After you install the operators, complete the following tasks to finish your Cloud Pak for Integration installation:

Add your IBM entitlement key so that the cluster can pull Cloud Pak for Integration images from the IBM Entitled Container Fulfillment Registry. For more information, see Finding and applying your entitlement key by using the CLI (online installation).
Deploy the Platform UI by following the procedure in Deploying the Platform UI on AKS. The Platform UI provides a central location for deploying and managing instances.
Deploy instances and integrations that you intend to use by following the procedures in Deploying instances.