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

> Install Arize AX on Red Hat OpenShift, including ROSA and private cloud topologies.

## Overview

This section provides guidance for installing Arize AX on Red Hat OpenShift, including Red Hat OpenShift Service on AWS (ROSA). The diagram below shows a typical OpenShift private-cloud topology.

![](https://storage.googleapis.com/arize-assets/assets/images/arize-docs-images/e38827ba-image.jpeg)

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](/ax/selfhosting/getting-started/prerequisites), including [deployment types](/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.

<Steps>
  <Step title="Download the distribution">
    Obtain the distribution archive with your JWT, extract it, and review the Helm chart, scripts, Terraform, and example manifests included in the bundle.

    <CardGroup cols={1}>
      <Card title="Download and extract" href="/ax/selfhosting/getting-started/download-and-unpack-the-distribution" icon="download">
        JWT, `get_latest.sh`, folder layout, and what to open next.
      </Card>
    </CardGroup>
  </Step>

  <Step title="OpenShift cluster and infrastructure">
    Prepare namespaces, SCC-compatible security context values, object storage, storage classes, and registry access for the OpenShift target.

    <CardGroup cols={1}>
      <Card title="Existing OpenShift cluster" href="/ax/selfhosting/installation/openshift/cluster-existing-openshift" icon="boxes">
        ROSA and private-cloud requirements, sizing, storage, namespaces, and SCC-aligned security context notes.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Install Arize AX">
    Configure `values.yaml` for OpenShift and install the operator chart from the extracted distribution directory.

    <CardGroup cols={2}>
      <Card title="Quick start" href="/ax/selfhosting/installation/openshift/install-arize-quickstart" icon="zap">
        Example OpenShift `values.yaml` and Helm command for a fast install path.
      </Card>

      <Card title="Detailed walkthrough" href="/ax/selfhosting/installation/openshift/install-arize-detailed" icon="book">
        Ceph/S3-compatible storage fields, base64 secrets, runAs IDs, `ingressMode`, and `arize.sh`.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Create ingress">
    Expose the UI and APIs with OpenShift ingress mode or the endpoint pattern your platform team standardizes on.

    <CardGroup cols={2}>
      <Card title="OpenShift ingress mode" href="/ax/selfhosting/installation/openshift/ingress-openshift" icon="route">
        Set `ingressMode: 'openshift'`, plan endpoint hostnames, and verify OpenShift routes or ingress resources.
      </Card>

      <Card title="Configuring endpoints" href="/ax/selfhosting/installation/ingress/configuring-endpoints" icon="plug">
        Hostnames, `appBaseUrl`, endpoint inventory, TLS, and DNS planning.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Validate the deployment">
    Confirm pods are healthy, ingress and DNS resolve, and the UI is reachable before sending data.

    <CardGroup cols={1}>
      <Card title="Validation checklist" href="/ax/selfhosting/installation/validate-deployment" icon="check-circle">
        `kubectl` health checks, ingress inspection, login, and SDK testing.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Use Arize AX">
    Open the public Arize AX documentation for product guides and configure your application with the on-prem SDK documentation.

    <CardGroup cols={3}>
      <Card title="Arize AX documentation" href="https://docs.arize.com" icon="book-open">
        Product documentation, quickstarts, and observability guides on docs.arize.com.
      </Card>

      <Card title="SDK usage (self-hosted)" href="/ax/selfhosting/guides/sdk-usage" icon="code">
        Python SDK versions and endpoint configuration for self-hosted deployments.
      </Card>

      <Card title="Integrations" href="/ax/selfhosting/guides/integrations" icon="plug">
        Framework and provider integrations for tracing and monitoring.
      </Card>
    </CardGroup>
  </Step>
</Steps>