Skip to main content
This feature is available for select Enterprise customers only.

Overview

Gateway Registration connects your self-hosted AI Gateway to the Portkey Control Plane. Once registered, the Data Plane can pull promt templates, routing configs,integrations, API keys etc. The registration flow has three steps:
  1. Register Gateway — provide a name, URL, and environment type
  2. Workspace Provisioning — choose which workspaces can use this gateway
  3. Save the deployment configuration — download and store the generated configuration for your deployment.

Step 1: Register Gateway

Navigate to Admin Settings → Gateway Registration and click Register New Gateway. Fill in the following fields:

Step 2: Workspace Provisioning

Workspace Provisioning is available on the Hybrid Enterprise plan only.
Choose which workspaces in your organisation will have access to this gateway.

Workspace Access Options

All current and future workspaces in your organisation can route traffic through this gateway. No further configuration is needed.
Click Next to continue.

Step 3: Save the deployment configuration

Download the values.yaml configuration file generated for your deployment.
Save this configuration before leaving. It will not be accessible again after you navigate away from this screen. Use the Download values.yaml button to save a local copy.

Gateway Overview

After registration, you can manage your gateway from Admin Settings → Gateway Registration → [Gateway Name]. The overview page shows:
  • Status badge (active / inactive) — updated when you run Verify Connection.
  • Workspace Control tab — edit workspace access permissions after registration.
  • Last Sync — elapsed time since the most recent sync between the data plane and control plane.

Disable the SaaS Gateway

The SaaS Gateway toggle at the top of the Gateway Registration page controls whether your organisation can send traffic to the Portkey SaaS gateway. Turn it off to route all traffic through your own registered gateways.
SaaS Gateway toggle on the Gateway Registration page, shown as Disabled
When the toggle is Disabled, the SaaS AI gateway and the SaaS MCP gateway do not accept traffic for your account. Requests only work through gateways you have registered.
The toggle is available on all accounts. Only organisation admins can change it.
Point your applications and MCP clients at your registered gateways before disabling the SaaS Gateway. Requests that still use the SaaS gateway are not allowed once it is disabled.

Disable or re-enable

1

Open Gateway Registration

Go to Settings > Organisation > Gateway Registration.
2

Confirm a registered gateway is active

Check that at least one registration shows an Active status.
3

Switch the SaaS Gateway toggle

Turn the SaaS Gateway toggle off to disable the SaaS gateway, or on to re-enable it.

Deployment Steps

For Helm chart deployment details, refer to the values.yaml reference.

Connect to the Gateway

Once your gateway is running and registered, verify it is reachable and routing requests correctly.
Replace the following before running:

Portkey is now PRISMA AIRS AI Gateway. See it in action.

Contact Us
Last modified on November 12, 2026