Setup Polypheny

The easiest way to setup Polypheny is to use our latest release. On this page, we describe how to deploy Polypheny on different operating systems using these releases.


Everything is completely self-contained and comes with its own JVM (Java Virtual Machine). The sole dependency is Docker, although it is only necessary for certain features. Nevertheless, we highly recommend configuring Docker as it greatly simplifies the deployment of data stores.

If you have Docker installed on the machine where you install Polypheny, Polypheny will connect automatically. It is also possible to connect to Docker on another host. For detailed guidance on setting up Docker for Polypheny and utilizing the Docker-based data store deployment, please refer to this documentation.


We provide binaries for Windows, macOS and Linux. Furthermore, we provide a JAR which allows to deploy Polypheny on every system running Java.


Please download the .msi file from the GitHub release page and follow the installer. After the installation has completed, Polypheny can be started using the Desktop icon or the entry in the start menu. After Polypheny has been started, it adds itself to the system tray.


Please download the .dmg file from the GitHub release page. As usual, Polypheny is installed by dragging the Polypheny icon on the application folder. This adds Polypheny to the applications overview. After Polypheny has been started, it adds itself to the system tray.


We provide binaries for .deb and .rpm systems. These binaries come with systemd scripts for controlling Polypheny. Please check the manual of your Linux distribution on how to install the .deb or .rpm file.


Please use the .jar file provided on the release page. Polypheny requires a Java runtime version 11 or higher.

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 is started.