> 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.

# Deploy the Passport Proxy

The Passport Proxy runs inside your cloud, where it resolves secret references from your secret store at request time. This is why Passport Cloud never handles your real secrets. For more information, see [Passport Proxy](/passport/get-started/basics/concepts/#passport-proxy).

This section covers a production deployment of the proxy in your Kubernetes environment. It starts with getting access to the Passport registry, then configuring and installing the proxy. By the end, you'll have a running proxy that intercepts and logs API traffic and is ready to register with Passport Cloud.

This deployment process is only supported from macOS and Linux.

> **Info**
>
> To try Passport on your own machine first, ask your coding agent to [set up an evaluation proxy](/passport/reference/passport-plugin/work-with-agent/set-up-a-proxy/) with the Passport plugin.

## Prerequisites

Before you begin, make sure you have the following:

* macOS or Linux
* Docker installed and configured
* Helm 3.8 or later
* `openssl`
* Kubernetes 1.25 or later, with the following:
  * `kubectl` access and permission to create a namespace
  * An ingress controller
  * Permission to create an internal load balancer
* A TLS certificate for the management hostname
* Access to edit DNS for two hostnames

## What you'll need

To deploy the Passport Proxy, you'll work with the following:

| Item                | What it is                                                                                                      | Where it comes from                                                     |
| ------------------- | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| Registry credential | A key that lets you pull the proxy image and Helm chart from the Passport registry.                             | You generate it in the Passport app.                                    |
| Proxy keys          | A CA key and a reference key that the proxy needs to start.                                                     | You generate them in your own environment.                              |
| `values.yaml`       | The settings for your deployment, such as your organization ID, hostnames, secret store, and audit destination. | You export the chart's default file, then edit it for your environment. |

## Get registry access

The proxy image and Helm chart are served from the Passport registry, and you need a credential to pull them. [Get registry access](/passport/set-up/deploy/get-registry-access/) to generate a registry credential, pull the proxy image, and export the chart's default values.

## Configure the proxy

The proxy needs to know which organization it serves, have its own keys, and know where to find your credentials and send audit events before it can start. [Configure the Passport Proxy](/passport/set-up/deploy/configure-proxy/) to find your organization ID, generate the proxy's keys, and set the values in `values.yaml` for your environment.

## Install the proxy

[Install the Passport Proxy](/passport/set-up/deploy/install-proxy/) with Helm to run it in your cluster, confirm that it's running, and note the values you need to [register it in Passport](/passport/set-up/set-up-proxy/). This page also covers where to view logged API traffic.