Getting Started

This page gives an overview on how to deploy and use Chronos. To learn more about Chronos itself, check the about page. To get an overview on what Chronos can do for you, check the features page.


There are different approaches on how to setup Chronos. The easiest and recommend way is to use the install script. The GitHub readme outlines the necessary steps to install Chronos Control using the provided install script. Please make sure to check the requirements section and to install missing software if required.


If you already have an evaluation client for your system you now need to connect it with Chronos Control. In the Chronos terminology, the module which handles this communication is called Chronos Agent. We provide a reference implementation of Chronos Agent in Java. We recommend using this implementation for your projects because it supports all available features.

If you are using a non-jvm language, it is possible to write your own Chronos Agent. The whole communication between Chronos Agent and Chronos Control is REST-based which makes it easy to implement. Please get in touch with us if you implemented our own Chronos Agent library and consider sharing it.

With the MongoDB Demo Client we provide a demo implementation of an evaluation client supporting Chronos. This implementation wraps the Yahoo YCSB benchmark. Check to see how simple it is to enable an existing benchmark to be used with Chronos.


Please consider making Chronos even better by contributing to its development. This does not necessarily mean writing code; also contributions to this website or a documentation are equally appreciated. Please get in touch with us in case you are interested.

Spread the world

Open source software is from anyone for anyone. Here a few suggestions what you can do:

  • If you are a researcher, consider citing our demo paper in your next publication.
  • Tell your colleges about Chronos and support them with their first steps towards easy and reproducible evaluations.
  • Star the GitHub repository.

Get in touch with us

Please let us know if you have troubles with setting-up or using Chronos. Please either open an issue on GitHub or directly get in touch with us via e-mail.

Also if we did a good job and you have no issues with Chronos we are very happy to hear from you. Getting feedback on how Chronos improves your workflow motivates us to continuously improve Chronos and to add additional features.