Skip to main content
QZ Tray (Debian / Ubuntu)

Installing QZ Tray

In order to set up QZ Tray, you will need to follow a series of steps. If you require assistance or have any questions, please contact the relevant support team.

First, navigate to the QZ Tray Download page. Once you are on the page, select the most recent stable release, which can be identified by the green button on the left side of the page with a red arrow pointing to it. The orange button on the right side of the page is a pre-release version and is not recommended. For example, in the screenshot provided, the latest stable release is version 2.1.


Once you have downloaded the installation file to your computer, please open up a terminal and type the following commands:

    1. cd Downloads
    2. chmod +x
    3. DEBUG=true sudo -E ./
  • The first command will navigate into your downloads folder.
  • The second command will make the downloaded file an executable file.
  • The third command will run the setup file and handle the installation. You will be prompted to enter your user password once you enter the command in the terminal.

If you do not have Java Runtime installed, you will see an error message. 


To install Java Runtime, please execute the following commands in your terminal:

  1. sudo apt update
  2. sudo apt install default-jre

Once you see the output "Do you want to continue? [Y/n]" after executing the second command, please type "Y" in the terminal and press enter.

You will see "done" in the terminal output once the Java Runtime installation is finalized. We can now continue with our QZ Tray installation.

Type the following command once again in your terminal:

  • DEBUG=true sudo -E ./

If you get any pop-ups during the installation regarding the HTTPS certificates, please press "yes" to continue. This will install the https certificates for the program, which is a more secure way of communicating between devices and websites.

If you see the [success] Task spawn was successful after running the last command, you should now be done with the installation.

QZ Tray should be visible in your status bar as a green printer icon.


Right-click on the icon to double-check if the "Automatically start" option is active, which will start the program on its own every time you reboot the computer.


As the final step, you need to restart your browser to start using QZ Tray.

Please note that in order to set up QZ Tray with Despatch Cloud, you will need to have the login credentials for your Despatch Cloud account.