Polypheny Control

Polypheny Control is an automated build system for the Polypheny stack that allows to easily setup and monitor Polypheny. It is primarily used for automated benchmarks and testing of Polypheny. The provided API easily allows interacting with Polypheny Control from scripts. With the Control Connector we also provide a Java library, simplifying the interaction with Polypheny Control using Java applications.


To build and start Polypheny using Polypheny Control, you need to have a Java JDK of version 11 or higher installed on your system. Thanks to JGit, Polypheny Control contains a pure Java implementation of Git. Therefore, it is not required to have Git installed on the system.


Download the latest polypheny-control.jar from the release section. To start the browser-based user interface, execute polypheny-control.jar by specifying the parameter control.

java -jar polypheny-control.jar control

The interface can now be accessed on port 8070. This port can be changed by specifying another port using the parameter -p:

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

We strongly recommend not to use port 8080, 8081 and 8082 because these are the default ports of services offered by Polypheny-DB.

Data Folder

Polypheny stores files in the local file system. By default, this is done in a special folder called .polypheny in the home directory of the executing user. This location can be customized by setting a system environment variable called POLYPHENY_HOME pointing to the desired location before Polypheny-DB is started.

(Optional) Setup Docker

See this on how to setup Docker to use the built-in Docker-based data store deployment.

Build & Start Polypheny

First trigger a build of Polypheny using the update-button in the browser-based user interface of Polypheny Control. The Polypheny-DB and Polypheny-UI branch can be configured by clicking on the gear-button.

After building, Polypheny can be started by clicking on the start-button.

To initiate a build of Polypheny, click on the update button in the Polypheny Control user interface. Once the build process is complete, you can run Polypheny by clicking on the start button.

For configuring the Polypheny-DB and Polypheny-UI branch, simply click on the gear button. Make sure to trigger a build after changing the branch.

© Polypheny GmbH. All Rights Reserved.