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

> Topology, requirements, and install steps for Arize AX on Amazon EKS.

## Overview

The diagram below depicts the target topology for AWS.

![](https://storage.googleapis.com/arize-assets/assets/images/arize-docs-images/44346ada-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 or section 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="EKS cluster and AWS infrastructure">
    Prepare the EKS cluster, S3 buckets, storage classes, IAM permissions, and private-network endpoints needed by Arize AX.

    <CardGroup cols={2}>
      <Card title="Existing EKS cluster" href="/ax/selfhosting/installation/aws/cluster-existing-eks" icon="server">
        EKS node pools, S3 buckets, storage classes, IAM, IRSA, and VPC endpoint access.
      </Card>

      <Card title="Terraform" href="/ax/selfhosting/installation/aws/cluster-terraform" icon="cloud">
        Use bundled modules and README to provision EKS, networking, S3, IAM, and load-balancer support.
      </Card>
    </CardGroup>
  </Step>

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

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

      <Card title="Detailed walkthrough" href="/ax/selfhosting/installation/aws/install-arize-detailed" icon="book">
        Required AWS fields, base64 secrets, S3 buckets, IAM role, and registry settings.
      </Card>
    </CardGroup>
  </Step>

  <Step title="Create ingress">
    Expose the UI and APIs with the AWS load-balancing pattern your platform uses, or use NGINX, Istio, Kong, or another controller with the bundled example manifests.

    <CardGroup cols={2}>
      <Card title="AWS load balancer" href="/ax/selfhosting/installation/aws/ingress-aws-load-balancer" icon="cloud">
        AWS load balancer planning, endpoint examples, `appBaseUrl`, and DNS checks.
      </Card>

      <Card title="NGINX, Istio, Kong, ..." href="/ax/selfhosting/installation/ingress/other-controllers" icon="plug">
        Example paths under `examples/endpoints` and `ingressMode` guidance.
      </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>