Documentation

• ⛔️ 2.2 | ✅ 2.1 |✅ 2.0 | ⛔️ 1.9 | ...

Learn the recommended way to install, remove, or upgrade Java

Oracle drastically changed their licensing model and has stopped providing public updates for Java. The last free Oracle Java update was January 2019.

Because of this change, we have switched all development and testing to Eclipse Adoptium.

• OpenJDK 11 64-bit with the Hotspot JVM is our recommended version of Java for all platforms.

⚠️ Note: QZ Tray 2.2 bundles Java, so these steps are irrelevant.

• QZ Tray 2.0.10 or newer

1. Windows
2. macOS
3. Linux

1. Make sure QZ Tray and other Java dependent software are closed

   • The easiest way to close QZ Tray is to go to the System Tray > QZ Tray > Exit
   • Check Windows Task Manager for other Java program. Look for java.exe or javaw.exe in the process name/details.

2. Optional: Uninstall all Java versions

   • If you do not require a specific version of Java for another program, it is highly recommended to uninstall all versions currently installed prior to updating
   • To uninstall, go to Control Panel > Programs > Programs and Features

3. Download OpenJDK Temurin 11 64-bit (HotSpot JVM) from adoptium.net

4. Run the installer (e.g. OpenJDK11U-jdk_x64_windows_hotspot_11.0.14.1_1.msi)

   • When asked to select features, take defaults

5. Verify the Java version

   • Open a cmd prompt and type java -version

     

6. Launch QZ Tray

   • If no shortcut has been created, C:\ProgramData\Microsoft\Windows\Start Menu\Programs\QZ Tray

1. Make sure QZ Tray and other Java dependent software are closed

   • The easiest way to close QZ Tray is to go to the System Tray > QZ Tray > Exit
     • If QZ Tray is stuck in error you can close it and all Java processes using this command from terminal.
       Warning: This will end ALL Java apps that are running.

     sudo pkill -9 java

2. Optional: Uninstall all Java versions

   • If you do not require a specific version of Java for another program, it is highly recommended to uninstall all versions currently installed prior to updating

   • Open a terminal (found in Applications > Utilities) and type the following commands:

     sudo rm -fr /Library/Internet\ Plug-Ins/JavaAppletPlugin.plugin \
     sudo rm -fr /Library/PreferencePanes/JavaControlPanel.prefpane \
     sudo rm -rf /Library/LaunchAgents/com.oracle.java.Java-Updater.plist \
     sudo rm -rf /Library/PrivilegedHelperTools/com.oracle.java.JavaUpdateHelper \
     sudo rm -rf /Library/LaunchDaemons/com.oracle.java.Helper-Tool.plist \
     sudo rm -rf /Library/Preferences/com.oracle.java.Helper-Tool.plist
     
     # WARNING: Don't type the <> symbols, change it for your jdk version!
     sudo rm -rf /Library/Java/JavaVirtualMachines/jdk<version>.jdk
     sudo rm -rf /Library/Java/JavaVirtualMachines/adopt<version>.jdk
     sudo rm -rf /Library/Java/JavaVirtualMachines/temurin<version>.jdk

3. Download OpenJDK 11 64-bit (HotSpot JVM) from adoptium.net

   Note: If the JDK version is installed, that must be upgraded as well, as QZ Tray defaults to the JDK version.

4. Run the installer and follow the prompts on the screen

   • The download will look similar to OpenJDK11U-jdk_x64_mac_hotspot_11.0.3_7.pkg

5. Verify the Java version

   • Open up a terminal and type java -version. This will first return the JDK version on the system. If JDK is not installed, it will return the JRE version. Whatever version is displayed from this command is the version of Java that QZ Tray will use.
   

6. Launch QZ Tray

• If there is no desktop shortcut, start QZ Tray by going to Applications > QZ Tray

Adoptium has a PPA for Debian, Rhel, and OpenSUSE flavors of Linux. Below are instructions for Ubuntu. Adoptium's documentation for other flavors can be found here.

Alternatively, you may download and install OpenJDK11 directly from adoptium.net

Note these instructions were adapted from here

1. Make sure QZ Tray and other Java dependent software are closed

   • The easiest way to close QZ Tray is to go to the System Tray > QZ Tray > Exits

   # Ensure the necessary packages are present:
   sudo apt-get install -y wget apt-transport-https gnupg
   
   # Download the Eclipse Adoptium GPG key:
   wget https://packages.adoptium.net/artifactory/api/gpg/key/public && sudo apt-key add public
   
   # Configure the Eclipse Adoptium apt repository
   echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
   
   # Install the Temurin version 11
   sudo apt-get update
   sudo apt-get install temurin-11-jdk

2. Verify Java Version

   java -version

   If the wrong version of Java is displayed, you can use this command to switch

   sudo update-alternatives --config java
   

   

3. Launch QZ Tray

   If there is no desktop shortcut:

   • Search for "QZ Tray"
   • Go to usr/share/applications and find QZ Tray