> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.usepassport.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.usepassport.ai/_mcp/server.

# Get registry access

The proxy image and Helm chart are served from the Passport registry at `ociregistry.usepassport.ai`. You pull them using a credential generated in your team's Registry settings. This page covers generating the credential and pulling the image and chart.

## Generate a registry credential

A registry credential is a key that lets your machine and your Kubernetes cluster sign in to the Passport registry. You need one to pull the Passport Proxy image and Helm chart. Your team has one registry credential, and everything that pulls from the registry uses it.

A Passport Admin generates the credential in the Passport app. Its value is shown only once, when it's created, so store it in your secret manager.

To generate a registry credential, do the following:

1. In the Passport app, click **Org Settings** in the header.
2. Select **Registry**.
3. Click **Generate credential**.
4. Copy the credential value and export it as an environment variable:

   ```sh showLineNumbers={false}
   export PASSPORT_REGISTRY_KEY="<your-credential>"
   ```

> **Info**
>
> Store this credential securely. It won't be shown again after you leave the page. To replace or remove it later, see [Manage the registry credential](/passport/administer/manage-registry-credential/).

## Pull the Docker image

The proxy runs from a container image. Sign in to the Passport registry with your credential, then pull the image:

```sh showLineNumbers={false} wordWrap
printf '%s' "$PASSPORT_REGISTRY_KEY" | docker login ociregistry.usepassport.ai \
  --username passport --password-stdin

docker pull ociregistry.usepassport.ai/passport/passport-proxy:latest
```

Note the image name and tag for later. You'll need them when configuring `values.yaml`.

Kubernetes pulls the image itself when it starts the proxy, so it needs the credential too. A pull secret stores the credential in your cluster. Create one to let Kubernetes pull the image directly from the Passport registry instead of mirroring it to your own:

```sh showLineNumbers={false}
kubectl create secret docker-registry passport-registry \
  --docker-server=ociregistry.usepassport.ai \
  --docker-username=passport \
  --docker-password="$PASSPORT_REGISTRY_KEY"
```

Then reference `passport-registry` from your `values.yaml`.

## Pull the Helm chart and export default values

The Helm chart is the package that installs the proxy into your cluster. It includes a default `values.yaml` file that lists every setting you can configure.

Log Helm in to the same registry and write those defaults to a `values.yaml` file on your machine:

```sh showLineNumbers={false} wordWrap
printf '%s' "$PASSPORT_REGISTRY_KEY" | helm registry login ociregistry.usepassport.ai \
  --username passport --password-stdin

helm show values oci://ociregistry.usepassport.ai/passport/passport \
  --version 0.6.0 > values.yaml
```

## Next steps

With the image pulled and the chart's default values exported, [configure the Passport Proxy](/passport/set-up/deploy/configure-proxy/).