Skip to content
Switch branches/tags
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Polypheny Control

Polypheny Control allows to easily setup and monitor Polypheny-DB. It takes care of pulling the required repositories and executing the builds.

Originally, Polypheny Control has been designed as a tool for automating the evaluation and benchmarking of Polypheny-DB. Its integrated REST interface allows to easily integrate it into complex benchmarking scenarios.

Due to its easy to use user-interface, Polypheny Control is the recommended way for setting up Polypheny-DB.

Getting Started

This section describes how to setup Polypheny Control to build and run Polypheny-DB.


To build and start Polypheny-DB using Polypheny Control you need to have Java JDK in Version 8 or higher installed on your system. Thanks to JGit, Polypheny Control contains a pure Java implementation of Git. Therefore, it is no longer required to have Git installed on the system.


Download the latest polypheny-control.jar from the release section.

On systems with a desktop environment, Polypheny Control can be started by double-clicking the JAR file. Polypheny Control then adds itself to the system tray.

Alternatively, you can also execute the JAR file with the argument tray:

java -jar polypheny-control.jar tray


Polypheny Control can be started in healess mode by specifying the parameter control:

java -jar polypheny-control.jar control

The browser-based user interface can now be accessed on port 8070. This port can be changed using the parameter -p:

java -jar polypheny-control.jar control -p 8070

We strongly recommend not to use any port between 8080 and 8089 as these are the default ports of services offered by Polypheny-DB.

First Steps

After starting Polypheny Control, open the dashboard in your browser of choice by navigating to localhost:8070. If Polypheny Control is running in tray mode, the dashboard can also be opened by clicking on the icon in the system tray and selecting dashboard.

In order to start Polypheny-DB, we first need to trigger a build. This can be done by clicking on the 🔄 button. When the build has completed, run Polypheny-DB by clicking on ▶️.

You can now open the Polypheny-UI by opening localhost:8080 in your browser.


See the open issues for a list of proposed features (and known issues).


We highly welcome your contributions to Polypheny Control. If you would like to contribute, please fork the repository and submit your changes as a pull request. Please consult our Admin Repository for guidelines and additional information.

Please note that we have a code of conduct. Please follow it in all your interactions with the project.


Polypheny Control builds upon the great work of several other open source projects:


All these libraries are imported using WebJars.


  • Airline: Annotation-driven Java library for building command line interfaces.
  • Apache Commons: A bunch of useful Java utility classes.
  • GSON: Convert Java Objects into their JSON representation and vice versa.
  • Javalin: A simple and lightweight java web framework.
  • JGit: Pure Java implementation of the Git version control system.
  • Log4j: Fast and flexible logging framework for Java.
  • Project Lombok: A library providing compiler annotations for tedious tasks.
  • SLF4J: Provides a logging API by means of a facade pattern.
  • Typesafe Config: A configuration library using HOCON files.
  • WinP: Windows process management library.

These projects are used "as is" and are integrated as libraries.


The Apache 2.0 License