1. Install Java

   Java JDK version 11 or later must be installed on your system.

   Note: It is not sufficient to have the JRE (Java Runtime Environment) - you must have the JDK (Java Development Kit).

   Depending on your OS, Java is installed already. Some Linux distributions come with Java pre-installed.

   To check if the correct version of Java is installed, open a terminal and type:

   java --version

   You should see a message similar to the following one:

   openjdk 12.0.1 2019-04-16
       ...

   If you need to install Java then please proceed as follows:

   • The easiest way to install Java is to use your OS's package manager. For example, on some Linux distributions you can simply run a command like sudo apt-get install openjdk-11-jdk

     If your OS doesn't have a package manager, then you can download the Java JDK from here (GPL license), from here (Oracle license), or from another source of your choice.

   • Add the JDK's bin subdirectory to your operating system's PATH variable.

     Please consult your specific OS's documentation if you need help with this.

   • Check the installation, as explained above (java --version).

2. Install JavaFX (option)

   JavaFX version 11 or later can optionally be installed on your system.

   If you don't install JavFX, you can still use PPL, but no GUI functionality will be available.

   The easiest way to install JavaFX is to use your OS's package manager.

   If your OS doesn't have a package manager, then you can download JavaFX from here.

   Install the SDK and create an OS environment variable PATH_TO_FX that points to the SDK's lib sub-directory (e.g. PATH_TO_FX=/path/to/javafx-sdk-11/lib).

   Install the jmods also, and create an OS environment variable PATH_TO_FX_JMODS that points to its root directory (e.g. PATH_TO_FX_JMODS=/path/to/javafx-jmods-11).

3. Install PPL

   • Download file ppl-2021-09-03-linux.tar.gz for Linux/macOS/Unix or ppl-2021-09-03-windows.zip for Windows and unzip it into a directory of your choice.

   • Add PPL's bin subdirectory to your operating system's PATH variable.

     Please consult your specific OS's documentation if you need help with this.

     Restart your computer (unless this is not necessary after modifying the PATH variable on your OS).

4. Check

   To verify your installation open a terminal and type:

   ppl check

For information on how to use PPL, please refer to the documentation.

If you need further help then please send an email to contact {at} ppl-lang {dot} dev.

Enjoy!