Part 1.1: Install Java 11

This is an environment setup step and is only required the first time you write a plugin on your computer.

Plugins for Funnelback are written using Java 11. This must be installed in order to develop a plugin for use with Funnelback.

Downloading Java 11

  1. Open your web browser and visit the Adoptium website.

  2. Download Eclipse Temurin 11 - LTS JDK for your operating system. You must download the Java Development Kit (JDK) package as you will be developing plugins. The (smaller) Java Runtime Environment (JRE) is not suitable.

    You must use Java 11 as this is the version currently used by Funnelback. Other versions of Java (both newer and older) will not be fully compatible.
  3. Install Java by running the installer.

Ensure that java is on your path

After installing java, it should now be available on your path.

  1. Open a terminal or command prompt and run:

    $ java --version

    A message similar to the one below should be displayed if Java was successfully installed:

    openjdk 11.0.21 2023-10-17
    OpenJDK Runtime Environment Temurin-11.0.21+9 (build 11.0.21+9)
    OpenJDK 64-Bit Server VM Temurin-11.0.21+9 (build 11.0.21+9, mixed mode)

If you’ve upgraded from an older version of the JDK you may find that the version listed when running java --version is reflecting the old version, or that the above command doesn’t work. If this is the case you need to update your JAVA_HOME environment variable (or add one) to point to the new Java version, then reload your environment variables (or restart your shell). After this is done correctly the above command should reflect the correct Java version.

e.g. on my Mac the following is included in my ~/.zshrc to set the JAVA_HOME environment variable.

export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-11.jdk/Contents/Home

Next steps

The next tutorial covers the installation of Apache Maven.