Compiling Plex

Compiling Plex is straightforward as there are no dependencies that need to be added manually. Plex uses Gradle as the build system. All compiling instructions are in the build.gradle.kts file. Note that you can download an already compiled version of Plex from the CI Server.

Prerequisites

Please ensure that you have Java 21 installed on your computer, as Plex requires JDK 21 to compile. You will get an error if you try to use an older version. If you have Java 21 installed, it may not be set in your path. If you do not already have Java installed, the recommended place to get Java is from Adoptium. In the installer, there is an option to set JDK 21 to your path. You must select that option if it is not already selected by default. Plex does not require, but recommends having Git installed on your computer. If you do not want to install Git, you may download the source code manually. Git for Windows can be downloaded here. macOS and Linux users should already have Git installed by default.

Using the command line

First, clone the Plex source code from GitHub on to your computer using the following command.

git clone https://github.com/plexusorg/Plex

Next, change your working directory to the Plex folder.

cd Plex-master

Gradle is already included in the folder with Plex. Run the following command below based on your operating system to compile Plex.

./gradlew build

gradlew.bat build

./gradlew build

You should receive a message indicating the compilation was successful. The JAR files for the Server and Proxy are located in the build/libs folder.

Plex has no external dependencies and can be used right away after compilation. See Versions to see what the compatibility for Plex is. You also must be running Java 21 on the server itself.

Troubleshooting

If you receive an error that says Permission denied, run chmod a+x gradlew. Note that this only applies to macOS / Linux users.