Installation

Install Agentgateway from source, pre-built binaries, or Docker.

Agentgateway is a single binary written in Rust. Choose the installation method that fits your environment.

Build from source

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 binary

Pre-built binaries are available for Linux and macOS on the GitHub Releases page.

Download and install

Linux (x86_64)

# 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

# Download the latest release
curl -LO https://github.com/agentgateway/agentgateway/releases/latest/download/agentgateway-linux-arm64

# Make it executable and move to your PATH
chmod +x agentgateway-linux-arm64
sudo mv agentgateway-linux-arm64 /usr/local/bin/agentgateway

# Download the latest release
curl -LO https://github.com/agentgateway/agentgateway/releases/latest/download/agentgateway-darwin-arm64

# Make it executable and move to your PATH
chmod +x agentgateway-darwin-arm64
sudo mv agentgateway-darwin-arm64 /usr/local/bin/agentgateway

Verify the installation

agentgateway --version

Always check the releases page to confirm the exact binary names for each release, as naming conventions may vary between versions.

Docker

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

docker-compose.yml

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

./target/release/agentgateway -f config.yaml

agentgateway -f config.yaml

cargo run -- -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_CLI	Set to true when building from source to use the system git for fetching dependencies. Required in some restricted network environments.
RUST_LOG	Controls log verbosity. Example: RUST_LOG=info agentgateway -f config.yaml. Accepts error, warn, info, debug, trace.
VERSION	Embedded at build time to set the version string reported by --version.
GIT_REVISION	Embedded 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.