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

> Deploy self-hosted Arize AX on a Rancher-managed Kubernetes cluster: cluster prep, distribution install, ingress, and validation.

## Overview

Use this page when Kubernetes is already running and is managed by Rancher. Rancher can manage clusters across cloud, private cloud, and bare-metal infrastructure; this guide starts from an existing Rancher-managed Kubernetes cluster and does not cover provisioning Rancher or the underlying hosts.

Your platform team owns the cluster-level choices: storage classes, ingress, DNS, registry access, and object storage. The Arize AX install flow is still the same: point `kubectl` at the target cluster, create `values.yaml` next to `arize.sh`, then run `./arize.sh install` from the extracted distribution directory.

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

**Read the ordered steps below once** so you know the sequence (download -> cluster/storage -> values -> install -> ingress -> validate). Then open each linked page below; you can return here anytime as the hub.

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

    <CardGroup cols={1}>
      <Card title="Download and extract" href="/docs/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="Prepare cluster and storage">
    Confirm kubeconfig, namespaces, storage classes, object storage, sizing, and Rancher-specific cluster constraints before installing.

    <CardGroup cols={1}>
      <Card title="Cluster and storage" href="/docs/ax/selfhosting/installation/rancher-bare-metal/cluster-and-storage" icon="database">
        Kubeconfig, namespaces, object storage, sizing, small-cluster values, tolerations, and baseOverlay guidance.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Install Arize AX">
    Create `values.yaml` in the extracted distribution directory, run the installer, and apply platform-specific adjustments when needed.

    <CardGroup cols={2}>
      <Card title="Install Arize AX" href="/docs/ax/selfhosting/installation/rancher-bare-metal/install-arize" icon="terminal">
        Create `values.yaml`, encode secrets, run `./arize.sh -y -t 5400 install`, and handle namespace ownership.
      </Card>

      <Card title="Restricted PodSecurity" href="/docs/ax/selfhosting/installation/rancher-bare-metal/talos-podsecurity" icon="shield">
        Promtail `hostPath`, PodSecurity baseline, and policy guidance.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Create ingress">
    Expose the UI and APIs with the ingress controller, load balancer, DNS, and TLS pattern your platform team standardizes on.

    <CardGroup cols={2}>
      <Card title="Configuring endpoints" href="/docs/ax/selfhosting/installation/ingress/configuring-endpoints" icon="route">
        Hostnames, `appBaseUrl`, endpoint inventory, TLS, and DNS planning.
      </Card>

      <Card title="NGINX, Istio, Kong, ..." href="/docs/ax/selfhosting/installation/ingress/other-controllers" icon="plug">
        Example paths under `examples/endpoints` and `ingressMode` guidance.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Validate and troubleshoot">
    Check operator status, pods, jobs, and logs. Use cleanup guidance only when intentionally discarding a previous install.

    <CardGroup cols={2}>
      <Card title="Validate and troubleshoot" href="/docs/ax/selfhosting/installation/rancher-bare-metal/validate-troubleshoot" icon="check-circle">
        Operator status, pods, jobs, stuck-job recovery, and log-safety reminders.
      </Card>

      <Card title="Fresh reinstall cleanup" href="/docs/ax/selfhosting/advanced/fresh-reinstall-cleanup" icon="clock-rotate-left">
        Destructive reset path for intentionally discarded installs.
      </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="/docs/ax/selfhosting/guides/sdk-usage" icon="code">
        Python SDK versions and endpoint configuration for self-hosted deployments.
      </Card>

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