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

Deploy the binary

Deploy agentgateway as a standalone binary on your system.

To run agentgateway as a standalone binary, follow the steps to download, install, and configure the binary on your local machine or server.

Install the binary

Download and install

Download and install the agentgateway binary. Alternatively, you can manually download the binary from the agentgateway releases page.

To install the latest release:

curl -sL https://agentgateway.dev/install | bash

Example output:

  % Total    % Received % Xferd  Average Speed   Time    Time     Time     Current
                                 Dload  Upload   Total   Spent   Left    Speed
100  8878  100  8878    0     0  68998      0 --:--:-- --:--:-- --:--:-- 69359

Downloading https://github.com/agentgateway/agentgateway/releases/download/v0.4.16/agentgateway-darwin-arm64
Verifying checksum... Done.
Preparing to install agentgateway into /usr/local/bin
Password:
agentgateway installed into /usr/local/bin/agentgateway

Verify the installation

Verify that the agentgateway binary is installed.

agentgateway --version

Example output with the latest version, 1.3.0:

{
  "version": "1.3.0",
  "git_revision": "90f7b25855fb5f5fbefcc16855206040cba9b77d",
  "rust_version": "1.89.0",
  "build_profile": "release",
  "build_target": "x86_64-unknown-linux-musl"
}

Run agentgateway

To run agentgateway, the binary can simply be executed. Configuration will be stored in ~/.config/agentgateway

agentgateway

To specify an explicit configuration file, use -f:

agentgateway -f config.yaml

You might start with this simple example configuration file.

Open http://localhost:15000/ui to get started!

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/.