Portkey is also available on the Azure Marketplace. You can deploy Portkey directly through your Azure console, which streamlines procurement and deployment processes.Deploy via Azure Marketplace →
Components and Sizing Recommendations
Prerequisites
Ensure the following tools and resources are installed and available:- A running AKS cluster with at least 2 worker nodes. (Best Practice: Use 2 nodes, with one node in each Availability Zone, to ensure high availability.)
- Azure CLI
- Kubectl
- Helm (v3 or above)
Create a Portkey Account
- Go to the Portkey website.
- Sign up for a Portkey account.
- Once logged in, locate and save your
Organisation IDfor future reference. It can be found in the browser URL:https://app.portkey.ai/organisation/<organisation_id>/ - Contact the Portkey AI team and provide your Organisation ID and the email address used during signup.
- The Portkey team will share the following information with you:
- Docker credentials for the Gateway images (username and password).
- License: Client Auth Key.
Setup Project Environment
Image Credentials Configuration
Configure Components
Based on the choice of components and their configuration update thevalues.yaml.
MCP Gateway (Optional)
By default, only the AI Gateway is enabled in the deployment. To enable the MCP Gateway, add the following configuration tovalues.yaml:
MCP_GATEWAY_BASE_URLmust include the protocol prefix — eitherhttp://orhttps://.- This value is not required for the initial deployment. After the first deployment, once the MCP Load Balancer is provisioned and a hostname is mapped to the MCP Service, set this value and redeploy.
""(empty or not provided): Deploys only the AI Gateway. This is the default configuration."mcp": Deploys only the MCP Gateway."all": Deploys both the AI Gateway and MCP Gateway.
Cache Store
The Portkey Gateway deployment includes a Redis instance pre-installed by default. You can either use this built-in Redis or connect to an external cache likeAzure Cache for Redis or Azure Managed Redis.
Built-in Redis
No additional permissions or network configurations are required.Azure Managed Redis
To enable the gateway to work with an Azure Managed cache, ensure connectivity from AKS cluster.Log Store
Azure Blob Storage
- (Optional) If not already done, create an Azure Storage Account and a Blob Container to store LLM logs.
-
Set up access to the log store. The Gateway supports the following methods for connecting to the Blob Storage:
- Managed Identity
- Entra ID
values.yamlwith the following configuration.- Managed Identity
- Entra ID
-
(Optional) Configure log path format using
LOG_STORE_FILE_PATH_FORMAT. See Log Object Path Format for details.
Network Configuration
Set Up External Access
To make the Gateway service accessible externally, you can set up either of the following:- Azure Load Balancer with NGINX
Ingresscontroller - Azure Load Balancer with Kubernetes
Service
Azure Load Balancer with NGINX Ingress Controller
Recommended ifSERVER_MODE is set to all
- Enable application routing add-on.
- Create NGINX Ingress Controller
- Update
values.yamlwith following configuration
- Retrieve IP address of Azure Load Balancer.
-
If
SERVER_MODEis set toall(i.e., both AI Gateway and MCP Gateway are enabled), you must enable host-based routing by settinghostBased: trueand specify the hostname through which the AI Gateway and MCP Gateway will be accessed. -
After the Load Balancer is provisioned, create a DNS record in your public or private hosted zone that points to the Load Balancer’s static public or private IPv4 address. If
SERVER_MODEis set toall, you must create two separate DNS records—one for the AI Gateway hostname and one for the MCP Gateway hostname—each pointing to the Load Balancer IP. - The Azure Load Balancer NGINX Controller supports additional annotations—such as TLS configuration, custom health checks, and more—for managing the Ingress load balancer. For a complete list of supported annotations, refer to the Azure NGINX Load Balancer ingress.
Azure Load Balancer with Kubernetes Service
service.containerPort must be same as environment.data.PORT.
Deploying Portkey Gateway
Verify the deployment
To confirm that the deployment was successful, follow these steps:- Verify that all pods are running correctly.
-
Test Gateway by sending a cURL request.
- Port-forward the Gateway pod
- Once port forwarding is active, open a new terminal window or tab and send a test request by running:
- Test gateway service integration with Load Balancer.
Integrating Gateway with Control Plane
Outbound Connectivity (Data Plane to Control Plane) Portkey supports the following methods for integrating the Data Plane with the Control Plane for outbound connectivity:- Azure Private Link
- Over the Internet
Azure Private Link
Establishes a secure, private connection between the Control Plane and Data Plane within the Azure network. Steps to establish Azure Private Link connectivity:- Contact Portkey and provide your Azure Subscription Id so it can be whitelisted in Portkey’s Control Plane.
- Once you get confirmation from Portkey that your Azure account is whitelisted, create Azure Private Endpoint connection to Portkey Control Plane.
- Retrieve Private IP of created endpoint.
- Contact the Portkey team and share the endpoint name with them.
- Once the connection request is approved, create Private Hosted Zone and link it to Gateway VNet.
- Create a record in the PHZ pointing to Portkey’s Private Endpoint IP.
- Update the
values.yamlfile with the following environment variables.
- Re-deploy the gateway.
Over the Internet
Ensure Gateway has access to the following endpoints over the internet.https://api.portkey.aihttps://albus.portkey.ai
Inbound Connectivity (Control Plane to Data Plane)
- Azure Private Link
- IP Whitelisting
Azure Private Link
Establishes a secure, private connection between the Control Plane and Data Plane within the Azure network. Steps to establish Azure Private Link connectivity:-
Create a dedicated subnet for Azure Private Link Service.
-
On the Azure Portal, navigate to
Private Link servicesand click + Create to create a new Private Link Service (PLS). - Select the Subscription and Resource Group, provide a name for the PLS, and click Next.
- Under Outbound settings, select the Load Balancer created for the gateway. Then choose the appropriate frontend IP configuration of that Load Balancer.
-
In the
Source NAT subnetfield, select the dedicated PLS subnet created earlier, and click Next. -
Under Access security, select Restricted by subscription and whitelist the Portkey Control Plane subscription ID (
4bec865f-23ea-4d04-be20-3e883cbb3eb1). - Leave all other settings as default and click Create to provision the Private Link Service.
- Contact the Portkey team and share the alias of the created Private Link Service, along with the Gateway URL.
- Once the Portkey team has raised the connection request from their end, approve it by navigating to the PLS in the Azure Portal, then go to Private Endpoint connections and click Approve.
IP Whitelisting
Allows control plane to access the Data Plane over the internet by restricting inbound traffic to specific IP address of Control Plane. This method requires the Data Plane to have a publicly accessible endpoint. To whitelist, add an inbound rule to the Azure NSG or Firewall allowing connections from the Portkey Control Plane’s IPs (54.81.226.149, 34.200.113.35, 44.221.117.129) on required port.
To integrate the Control Plane with the Data Plane, contact the Portkey team and provide the Public Endpoint of the Data Plane.
Verifying Gateway Integration with the Control Plane
- Send a test request to Gateway using
curl. - Go to Portkey website -> Logs.
- Verify that the test request appears in the logs and that you can view its full details by selecting the log entry.
Uninstalling Portkey Gateway
Setting up Permission
Azure Blob Storage
To allow the Portkey Gateway to access Azure Blob Storage for log storage, permissions must be granted. Follow the steps below to set up these permissions according to your selected access method.- Managed Identity
- Entra Identity
- Specify the details:
- Fetch Identity associated with the AKS cluster.
- Grant identity a role that allows it to access Blob Storage.
Examples
Built-in Redis The following samplevalues.yaml below shows how to configure the built-in Redis cache and Azure Blob Storage for log store using Entra ID.

