Connect the gateway to AI Workspace

Requires AI Workspace

A gateway can register only with a running AI Workspace deployment. For what registering gains you, see Extend your gateway with AI Workspace.

Connecting a gateway takes two steps, in this order. First you add the gateway in AI Workspace, which issues a registration token for it. Then you give that token and the address of AI Workspace to the gateway runtime, which registers itself and stays connected.

Choose your path

Four pages cover those two steps, each for a different situation. Find the row that matches yours:

Situation	Page	What it covers
You want to try AI Workspace on your own machine first	Get started with AI Workspace	Running the control plane locally, then creating a gateway in it
You're connecting a gateway on either runtime	Connect AI gateways in production	The authoritative procedure for both Docker Compose and Kubernetes, including certificate trust
You need the console side — the gateway record and its token	Set up an AI Gateway	Adding a gateway in AI Workspace and obtaining its registration token
You're connecting a production Kubernetes gateway	Connect to AI Workspace	The gateway-side chart values and token storage

Verify the connection

Each path ends with its own check that the gateway registered. For a production connection, see Verify. For a Helm installation, see Step 3: Verify the connection.