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:
-
In the Passport app, click Org Settings in the header.
-
Select Registry.
-
Click Generate credential.
-
Copy the credential value and export it as an environment variable:
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.
Pull the Docker image
The proxy runs from a container image. Sign in to the Passport registry with your credential, then pull the image:
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:
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:
Next steps
With the image pulled and the chart’s default values exported, configure the Passport Proxy.

