For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
Install
Install agentgateway as a binary, a Docker container, or a Kubernetes Deployment with Helm.
Agentgateway runs the same proxy and reads the same configuration file in every installation method. What differs is who starts the process, where the configuration file lives, and whether that file is writable.
Choose an installation method
Review the following table to choose the method that fits your environment.
| Method | Use it when | Configuration file |
|---|---|---|
| Binary | You want to run agentgateway on a laptop or a virtual machine, or you are trying agentgateway for the first time. | A local file that you pass with -f, or one that agentgateway generates in your user config directory. Writable. |
| Docker | You want to run agentgateway in a Docker container without the need for a Kubernetes cluster. | A file or directory that you mount into the container. Writable, unless you mount it read-only. |
| Helm | You want Kubernetes to run and expose the proxy for you, but you do not want a control plane that manages the agentgateway pod for you. | A ConfigMap that Helm renders from your Helm values and mounts read-only. |
All three methods run agentgateway in standalone mode, where your configuration file is the source of truth. If you want a managed Kubernetes deployment with a control plane, Gateway API support, and dynamic Kubernetes resources instead, see Kubernetes control plane.
Install on a cloud provider
None of the installation methods change on a cloud provider, because agentgateway runs the same proxy and reads the same configuration file everywhere. What changes is which container runtime starts the process, how the process gets an identity, and where its configuration file comes from. For those provider-specific steps, and for the configuration that reaches a provider’s managed model service without an API key, see the following guides.
- AWS for Amazon ECS, Amazon EKS, and Amazon Bedrock.
- Google Cloud for Cloud Run, GKE, and Vertex AI.
- Azure for Azure Container Apps, AKS, and Azure OpenAI.
Guides
Binary
Install and run agentgateway as a standalone binary on your system.
Docker
Install and run agentgateway as a Docker container, on its own or with Docker Compose.
Helm
Install standalone agentgateway as a Kubernetes Deployment with the standalone Helm chart.
Kubernetes control plane
Where to find the docs for the managed Kubernetes deployment model, which is not a standalone …
