December 14, 2019

343 words 2 mins read



open source Kubernetes-native API gateway for microservices built on the Envoy Proxy

repo name datawire/ambassador
repo link
language Python
size (curr.) 266482 kB
stars (curr.) 2578
created 2017-03-30
license Apache License 2.0

Ambassador Build Status Docker Repository Join Slack

Ambassador is an open source Kubernetes-native API Gateway built on Envoy, designed for microservices. Ambassador serves as an Envoy-based ingress controller, but with many more features.

Key features include:


Ambassador deploys the Envoy Proxy for L7 traffic management. Configuration of Ambassador is via Kubernetes annotations. Ambassador relies on Kubernetes for scaling and resilience. For more on Ambassador’s architecture and motivation, read this blog post.

Getting Started

You can get Ambassador up and running in less than a minute by running it locally with Docker. Follow the instructions here:

For production usage, Ambassador runs in Kubernetes. For a Kubernetes deployment, follow the instructions at

If you are looking for a Kubernetes ingress controller, Ambassador provides a superset of the functionality of a typical ingress controller. (It does the traditional routing, and layers on a raft of configuration options.) This blog post covers Kubernetes ingress.

You can also use Helm to install Ambassador. For more information, see the instructions in the Helm installation documentation.


Ambassador is an open source project, and welcomes any and all contributors. To get started:

If you’re interested in contributing, here are some ways:

The Ambassador Edge Stack is a superset of the Ambassador API Gateway that provides additional functionality including OAuth/OpenID Connect, advanced rate limiting, Swagger/OpenAPI support, integrated ACME support for automatic TLS certificate management, and a UI. For more information, visit

comments powered by Disqus