This project has retired. For details please refer to its Attic page.
Apache Aurora


Aurora is a service scheduler that schedules jobs onto Mesos, which runs tasks at a specified cluster. Typical services consist of up to hundreds of task replicas.

Aurora provides a Job abstraction consisting of a Task template and instructions for creating near-identical replicas of that Task (modulo things like “instance id” or specific port numbers which may differ from machine to machine).

Terminology Note: Replicas are also referred to as shards and instances. While there is a general desire to move to using “instances”, “shard” is still found in commands and help strings.

Typically a Task is a single Process corresponding to a single command line, such as python2.6 However, sometimes you must colocate separate Processes together within a single Task, which runs within a single container and chroot, often referred to as a “sandbox”. For example, if you run multiple cooperating agents together such as logrotate, installer, and master or slave processes. Thermos provides a Process abstraction under the Mesos Tasks.

To use and get up to speed on Aurora, you should look the docs in this directory in this order:

  1. How to deploy Aurora or, how to install Aurora on virtual machines on your private machine (the Tutorial uses the virtual machine approach).
  2. As a user, get started quickly with a Tutorial.
  3. For an overview of Aurora’s process flow under the hood, see the User Guide.
  4. To learn how to write a configuration file, look at our Configuration Tutorial. From there, look at the Aurora + Thermos Reference.
  5. Then read up on the Aurora Command Line Client.
  6. Find out general information and useful tips about how Aurora does Resource Isolation.

To contact the Aurora Developer List, email You may want to read the list archives. You can also use the IRC channel #aurora on