Python Shell HTML Makefile Dockerfile JavaScript Smarty
Clone or download
Latest commit 17dcd53 Aug 14, 2018
Failed to load latest commit information.
.github/ISSUE_TEMPLATE update issues template May 11, 2018
ambassador Merge pull request #617 from KowalczykBartek/default_cors_handling Aug 8, 2018
docs one more link to fix Aug 14, 2018
end-to-end Refactor end-to-end README Aug 8, 2018
helm/ambassador fix formatting Aug 13, 2018
k8s Revert listener-port changes related to running as non-root. We'll Jun 26, 2018
releng Add release-prep target for 1-Click Releases Aug 8, 2018
scripts Apache License headers on Python, shell scripts and HTML Jun 26, 2018
statsd-sink move to templates Feb 2, 2018
statsd Don't log socat notice messages as it is flooding the logs Apr 10, 2018
templates fix for 630 Aug 9, 2018
.gitignore add re-running tests Jul 31, 2018
.nvmrc Add Netlify Jul 19, 2017
.travis.yml OMG, Travis, seriously? May 15, 2018 Update docs and CI for new branch model. Aug 7, 2018 Ambassador 0.38.0 release Aug 8, 2018
LICENSE Add LICENSE and update .gitignore May 5, 2017
Makefile Add release-prep target for 1-Click Releases Aug 8, 2018 Point to Helm chart README in main README. Jun 28, 2018 Update with release-prep Aug 8, 2018 Apache License headers on Python, shell scripts and HTML Jun 26, 2018
dev-requirements.txt Kubernaut isn't a dev requirement, it's a test requirement that we ca… Feb 2, 2018
kubernaut-config.json.enc install encrypted kubernaut token May 1, 2018
stats_walkthrough.txt Update with Graphite URLs and info Apr 28, 2017

Ambassador Build Status Docker Repository

Ambassador is an open source Kubernetes-native API Gateway built on Envoy, designed for microservices. Ambassador essentially serves as an Envoy 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 chart README.


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: