Skip to content
🎯 New workshop: Govern AI Costs in Real Time — Hands-On with agentgateway agentgateway has joined the Agentic AI FoundationLearn more

For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Page as Markdown

Admin UI

Use the built-in Admin UI to inspect your Kubernetes agentgateway proxy configuration.

Use the agentgateway Admin UI to inspect your Kubernetes proxy configuration.

About

The agentgateway Admin UI is a built-in web interface that runs on port 15000 of the agentgateway-proxy pod. In Kubernetes mode, the UI is read-only. It reflects the configuration that the agentgateway controller pushes to the proxy over xDS, the protocol that the control plane uses to deliver configuration to the proxy.

The Admin UI is read-only in Kubernetes mode. Unlike standalone mode, you cannot use the UI to add features such as models, LLM providers, or MCP servers. Instead, make configuration changes by updating your Kubernetes resources, such as through GitOps, not through the UI.

The Admin UI is useful for debugging and verifying the configuration that the proxy received from the controller, such as confirming that a Gateway, HTTPRoute, AgentgatewayBackend, or AgentgatewayPolicy resource took effect.

Access the Admin UI

The Admin UI is not exposed as a Kubernetes Service. To access it, use kubectl port-forward to forward the pod’s port to your local machine.

  1. Forward port 15000 from the agentgateway-proxy deployment to your local machine.

    kubectl port-forward deployment/agentgateway-proxy -n agentgateway-system 15000

    Example output:

    Forwarding from 127.0.0.1:15000 -> 15000
    Forwarding from [::1]:15000 -> 15000
  2. While the port-forward is running, open http://localhost:15000/ui/ in your browser.

    The Gateway Overview opens in read-only mode and summarizes the resources that the proxy currently serves, such as the number of listeners, routes, and policies.

The port-forward connection closes when you stop the kubectl port-forward command. Run it in a dedicated terminal tab or in the background if you need persistent access.

Explore the read-only views

Because configuration is managed by xDS, every page shows a read-only mode banner and editing is disabled. The views reflect the configuration that the proxy currently runs, so use them to verify that the proxy received the configuration that you expect. The navigation menu groups the views into Gateway, Traffic, and Tools.

Listeners

The Listeners page lists the ports that the proxy binds and the routes that are attached to each listener. Use it to confirm the proxy’s port bindings and how routes map to each listener.

Routes

The Routes page is an inventory of the routes that the proxy currently runs. Each row shows the route name, type, listener, path match, backends, and the number of attached policies. To inspect a single route in more detail, click the view (eye) icon in its row.

Policies

The Policies page lists the policies that the proxy currently runs, including the resource that each policy targets, the policy type, and how the policy is inherited.

CEL Playground

The CEL Playground, under Tools, lets you evaluate Common Expression Language (CEL) expressions against sample input. It is the only interactive tool available in Kubernetes mode, and it does not modify any configuration. For more information about where agentgateway uses CEL, see the CEL expressions reference.

Was this page helpful?
Agentgateway assistant

Ask me anything about agentgateway configuration, features, or usage.

Note: AI-generated content might contain errors; please verify and test all returned information.

Tip: one topic per conversation gives the best results. Use the + button in the chat header to start a new conversation.

Switching topics? Starting a new conversation improves accuracy.
↑↓ navigate select esc dismiss

What could be improved?

Your feedback helps us improve assistant answers and identify docs gaps we should fix.

Need more help? Join us on Discord: https://discord.gg/y9efgEmppm

Want to use your own agent? Add the Solo MCP server to query our docs directly. Get started here: https://search.solo.io/.