Agentgateway is a single binary written in Rust. Choose the installation method that fits your environment.
Build from source
Pre-built binary
Docker
Building from source gives you the latest code and the ability to customize the build. Requirements Dependency Minimum version Rust + Cargo 1.86+ npm 10+ make Any recent version
Install Rust via rustup : curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Install Node.js and npm via nodejs.org or your system package manager. Clone the repository git clone https://github.com/agentgateway/agentgateway.git cd agentgateway
Build the UI Agentgateway ships with a built-in admin UI. Build it first so it can be embedded into the binary: cd ui npm install npm run build cd ..
Build the binary export CARGO_NET_GIT_FETCH_WITH_CLI = true make build
The compiled binary is placed at: ./target/release/agentgateway
For faster incremental builds during development, use the quick-release profile: cargo build --profile quick-release
This trades some optimization for faster compile times — suitable for development but not production. Verify the installation ./target/release/agentgateway --version
Pre-built binaries are available for Linux and macOS on the GitHub Releases page. Download and install Linux (x86_64)
Linux (arm64)
macOS (Apple Silicon)
# Download the latest release curl -LO https://github.com/agentgateway/agentgateway/releases/latest/download/agentgateway-linux-amd64 # Make it executable and move to your PATH chmod +x agentgateway-linux-amd64 sudo mv agentgateway-linux-amd64 /usr/local/bin/agentgateway
Verify the installation Always check the releases page to confirm the exact binary names for each release, as naming conventions may vary between versions. The official Agentgateway Docker image is published to the GitHub Container Registry. Pull the image docker pull ghcr.io/agentgateway/agentgateway:latest
Run with a config file Mount your config.yaml into the container and pass it via the -f flag: docker run --rm \ -p 3000:3000 \ -p 15000:15000 \ -v $( pwd ) /config.yaml:/config.yaml \ ghcr.io/agentgateway/agentgateway:latest \ -f /config.yaml
This exposes:
Port 3000 — the MCP/A2A proxy listener (matches the basic example config)Port 15000 — the admin API and UI Build the image locally The project includes a multi-stage Dockerfile that builds both the UI and the Rust binary: docker build -t agentgateway:local .
The image uses a Chainguard glibc-dynamic base for a minimal, hardened runtime layer. Targets for both linux/amd64 and linux/arm64 are supported via the TARGETARCH build argument. To build for a specific architecture: docker buildx build --platform linux/arm64 -t agentgateway:arm64 .
Compose example services : agentgateway : image : ghcr.io/agentgateway/agentgateway:latest command : [ "-f" , "/config.yaml" ] ports : - "3000:3000" - "15000:15000" volumes : - ./config.yaml:/config.yaml
Running Agentgateway Once installed, start the gateway by pointing it at a config file:
Binary
Installed in PATH
cargo run
./target/release/agentgateway -f config.yaml
With no config file provided, Agentgateway starts with an empty configuration and exposes only the admin interface.
Admin UI Agentgateway includes a built-in admin UI available at:
http://localhost:15000/ui
The UI lets you inspect the running configuration, browse connected backends, and view active listeners and routes — without restarting the process.
The admin interface listens on port 15000 by default. This is separate from your proxy listener port (e.g., 3000 in the basic example). Do not expose port 15000 publicly in production.
Environment variables Variable Description CARGO_NET_GIT_FETCH_WITH_CLISet to true when building from source to use the system git for fetching dependencies. Required in some restricted network environments. RUST_LOGControls log verbosity. Example: RUST_LOG=info agentgateway -f config.yaml. Accepts error, warn, info, debug, trace. VERSIONEmbedded at build time to set the version string reported by --version. GIT_REVISIONEmbedded at build time alongside VERSION for traceability.
Next steps
Quickstart Run the basic MCP proxy example end-to-end.
MCP Proxy Guide Configure authentication, authorization, and observability for MCP.
Docker deployment Production Docker deployment patterns and best practices.
Kubernetes deployment Deploy Agentgateway on Kubernetes using the Gateway API.
