Skip to content
Runs, manages, and autoscales web services on Mesos and Kubernetes
Branch: master
Clone or download
shamsimam and sradack adds support for populating WAITER_CLUSTER environment variable (#688)
* adds support for waiter cluster name env variable

* addresses feedback from DaoWen

* uses with-redefs on retrieve-cluster-name instead of populating the global config


* reverts changes to test-helpers
Latest commit 9279c3f Apr 19, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
cli Makes test_show_services_using_token more reliable (#701) Apr 18, 2019
kubernetes/fileserver-container Unset default nginx index file for k8s fileserver (#681) Apr 10, 2019
token-syncer adds support for accessing request and response trailers (#648) Apr 17, 2019
waiter adds support for populating WAITER_CLUSTER environment variable (#688) Apr 19, 2019
.gitignore Sync-ing latest waiter code - 20170704 (#48) Jul 6, 2017
LICENSE Create LICENSE Feb 8, 2017
waiter.svg Add logo to README (#195) Dec 29, 2017


Build Status Slack Status

Welcome to Two Sigma's Waiter project!

Waiter is a web service platform that runs, manages, and automatically scales services without requiring human intervention.

Waiter Design is a good place to start to learn more.

Subproject Summary

In this repository, you'll find two subprojects, each with its own documentation.

  • waiter - This is the actual web service platform, Waiter. It comes with a JSON REST API.
  • kitchen - This is the kitchen application, a test app used by the Waiter integration tests.

Please visit the waiter subproject first to get started.


The quickest way to get Mesos, Marathon, and Waiter running locally is with docker and minimesos.

  1. Install docker
  2. Install minimesos
  3. Clone down this repo
  4. Run kitchen/bin/ to build the minimesos agent image with kitchen baked in
  5. cd waiter
  6. Run minimesos up to start Mesos, ZooKeeper, and Marathon
  7. Run bin/ to start Waiter
  8. Waiter should now be listening locally on port 9091

Quickstart (local shell scheduling)

Waiter can also be run without Mesos and Marathon, using the "shell scheduler". Note that this scheduler should only be used for testing purposes, not in production.

  1. Clone down this repo
  2. cd waiter
  3. Run bin/ to start Waiter
  4. Waiter should now be listening locally on port 9091


In order to accept your code contributions, please fill out the appropriate Contributor License Agreement in the cla folder and submit it to


Apache Mesos is a trademark of The Apache Software Foundation. The Apache Software Foundation is not affiliated, endorsed, connected, sponsored or otherwise associated in any way to Two Sigma, Waiter, or this website in any manner.

© Two Sigma Open Source, LLC

You can’t perform that action at this time.