> ## Documentation Index
> Fetch the complete documentation index at: https://arize-ax.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Arize AX on IBM Cloud (quick start)

> Example values.yaml, Helm install command, and field checklist for the Arize AX operator on IBM Kubernetes Service (IKS) with IBM COS.

## Prerequisites

* Extracted tarball with `arize-operator-chart.tgz` and `arize.sh` in the current directory ([Download and extract](/docs/ax/selfhosting/getting-started/download-and-unpack-the-distribution)).
* `kubectl` configured for your IKS cluster ([IKS cluster and resources](/docs/ax/selfhosting/installation/ibm/cluster-existing-iks)).
* IBM COS buckets and HMAC credentials created.
* For how to gather each value, base64 encoding, optional registry fields, and `./arize.sh`, use the [detailed walkthrough (IBM Cloud)](/docs/ax/selfhosting/installation/ibm/install-arize-detailed).

## Helm install

From the directory that contains `arize-operator-chart.tgz` and your `values.yaml`:

```bash theme={null}
helm upgrade --install -f values.yaml arize-op arize-operator-chart.tgz
```

## Example `values.yaml` (IKS)

Adjust placeholders for your environment. Only values marked as base64-encoded should be base64-encoded.

```yaml theme={null}
cloud: "ceph"
clusterName: "<kubectl-context-name>"
# JWT from Arize AI, base64-encoded
hubJwt: "<JWT_BASE64>"
gazetteBucket: "<gazette-bucket-name>"
druidBucket: "<adb-bucket-name>"
# User-chosen secret, base64-encoded
postgresPassword: "<POSTGRES_PASSWORD_BASE64>"
organizationName: "<organization-or-company-name>"
# Encryption key, base64-encoded
cipherKey: "<CIPHER_KEY_BASE64>"
clusterSizing: "<sizing-option-from-arize-ai>"

# IBM COS — region must match buckets
cephS3Endpoint: "https://s3.<region>.cloud-object-storage.appdomain.cloud"
cephS3Region: "<region>"
cephS3AccessKeyId: "<HMAC_ACCESS_KEY_ID_BASE64>"
cephS3SecretAccessKey: "<HMAC_SECRET_ACCESS_KEY_BASE64>"

# IBM VPC block storage — confirm the class exists first: kubectl get storageclass
storageClassCephStandard: "ibmc-vpc-block-metro-retain-10iops-tier"
storageClassCephSsd: "ibmc-vpc-block-metro-retain-10iops-tier"

ingressMode: "tls"
collectNodeMetrics: true

# Only required if using a common node pool
historicalNodePoolEnabled: false

# URL for the Arize AX UI after ingress is configured
appBaseUrl: "https://<arize-app.domain>"
expBaseUrl: "<arize-app.domain>"

# Only required if using a private container registry
pushRegistry: "<registry-hostname>"
pullRegistry: "<registry-hostname>"
```

## Minimum fields to verify

| Area     | What to set                                                                                                                     |
| -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Identity | `hubJwt`, `organizationName`, `cipherKey`, `postgresPassword`                                                                   |
| IBM COS  | `cloud: "ceph"`, `gazetteBucket`, `druidBucket`, `cephS3Endpoint`, `cephS3Region`, `cephS3AccessKeyId`, `cephS3SecretAccessKey` |
| Cluster  | `clusterName`, `storageClassCephStandard`, `storageClassCephSsd`                                                                |
| Sizing   | `clusterSizing` from Arize AI                                                                                                   |
| Ingress  | `ingressMode: "tls"`, `appBaseUrl`, `expBaseUrl` once you know the hostname                                                     |

## Next steps

* [Configure ingress on IBM Cloud](/docs/ax/selfhosting/installation/ibm/ingress-ibm-cloud) or [other controllers](/docs/ax/selfhosting/installation/ingress/other-controllers)
* [Validate the deployment](/docs/ax/selfhosting/installation/validate-deployment)
* [Detailed walkthrough (IBM Cloud)](/docs/ax/selfhosting/installation/ibm/install-arize-detailed)