> ## 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.

# Installation on IBM Cloud

> Step-by-step path to deploy Arize AX on IBM Kubernetes Service (IKS).

## Overview

Use this path when you install Arize AX on **IBM Kubernetes Service (IKS)** with **IBM Cloud Object Storage (COS)** for Gazette and ArizeDB data. The primary guide assumes a standard Kubernetes cluster on IBM Cloud VPC Gen2.

**Red Hat OpenShift on IBM Cloud (ROKS)** is also supported on the same COS and VPC building blocks. These pages cover the standard IKS path; contact Arize AI for the ROKS-specific runbook.

Throughout this section, **distribution archive** means the **Arize AX release tarball** you download with your JWT (Helm chart, `arize.sh`, Terraform, examples, and offline HTML docs).

**Read the ordered steps below once** so you know the sequence (download → cluster → install → ingress → validate). Complete [Prerequisites](/docs/ax/selfhosting/getting-started/prerequisites), including [deployment types](/docs/ax/selfhosting/getting-started/deployment-types) for your network model, before you start. Then open each linked page below; you can return here anytime as the hub.

For the full Helm reference, use **Advanced → Helm** in the HTML documentation under **`docs/`** inside your extracted distribution archive.

**1. Download the distribution**

Obtain the distribution archive with your JWT, extract it, and review the Helm chart, scripts, and example manifests included in the bundle.

> **[Download and extract](/docs/ax/selfhosting/getting-started/download-and-unpack-the-distribution)**
>
> JWT, `get_latest.sh`, folder layout, and what to open next.

**2. IKS cluster and IBM Cloud resources**

Prepare an existing IKS cluster, IBM COS buckets, HMAC credentials and storage classes.

> **[Existing IKS cluster](/docs/ax/selfhosting/installation/ibm/cluster-existing-iks)**
>
> Worker sizing, COS buckets, HMAC keys, storage classes, and namespaces.

**3. Install Arize AX**

Configure `values.yaml` for IBM Cloud (`cloud: "ceph"`, COS HMAC, in-cluster or external Postgres) and install the operator chart.

> **[Quick start](/docs/ax/selfhosting/installation/ibm/install-arize-quickstart)**
>
> **Use when:** you want a complete example `values.yaml` and a single Helm command to get running fast.

> **[Detailed walkthrough](/docs/ax/selfhosting/installation/ibm/install-arize-detailed)**
>
> **Use when:** you need every field explained, base64 secrets, optional mirroring, and `./arize.sh` versus Helm called out step by step.

**4. Create ingress**

Expose the UI and APIs with an IBM Cloud load balancer or Ingress, or use NGINX, Istio, Kong, or another controller with the bundled example manifests.

> **[IBM Cloud load balancer](/docs/ax/selfhosting/installation/ibm/ingress-ibm-cloud)**
>
> LoadBalancer services, Ingress, `appBaseUrl` / `expBaseUrl`, and DNS.

> **[NGINX, Istio, Kong, …](/docs/ax/selfhosting/installation/ingress/other-controllers)**
>
> Example paths under `examples/endpoints` and `ingressMode` guidance.

**5. Validate the deployment**

Confirm pods are healthy, ingress and DNS resolve, and the UI is reachable before sending data.

> **[Validation checklist](/docs/ax/selfhosting/installation/validate-deployment)**
>
> `kubectl` health checks, ingress inspection, login, and SDK testing.

**6. Use Arize AX**

Open the public Arize AX documentation for product guides and configure your application with the on-prem SDK documentation.

> **[Arize AX documentation](https://docs.arize.com)**
>
> Product documentation, quickstarts, and observability guides on docs.arize.com.

> **[SDK usage (self-hosted)](/docs/ax/selfhosting/guides/sdk-usage)**
>
> Python SDK versions and endpoint configuration for self-hosted deployments.

> **[Integrations](/docs/ax/selfhosting/guides/integrations)**
>
> Framework and provider integrations for tracing and monitoring.