Using QZ Tray


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


This guide instructs how to properly download and install QZ Tray so that HTTPS is supported in all browsers on all operating systems. Currently Firefox is the only browser that requires any additional steps.

The screenshots may look different depending on your operating system and the version of QZ Tray you are running, but the steps in this article should be nearly identical.

Installing QZ Tray

  1. Install Java 7 or higher from Oracle's website.

    Note: QZ Tray 2.1 and HTML printing require Java 8 or higher. See detailed system requirements.

  2. Download the appropriate version of QZ Tray for your operating system


  3. Install, taking the defaults.

    Screenshot 2023-01-17 at 11 58 45 PM

Firefox steps

The following steps are required for Windows, Linux and Mac to gain HTTPS support in Firefox.

  • Currently, in order for HTTPS to work with Firefox, QZ Tray must be installed (or reinstalled) AFTER Firefox.
  • The certificate installation is performed when Firefox is opened, so closing all running versions of Firefox is required for HTTPS support.
  • Mac users will need to fully quit Firefox via Command (⌘) + Q.
  • PortableFirefox users will have to follow special instructions via the PortableFirefox Support page

Testing QZ Tray

  1. Open install folder via Tray Icon > Advanced > Open File Location

  2. Open sample.html from the demo folder. By default, this is located in C:\Program Files\QZ Tray\demo on Windows.

  3. When prompted to allow access, click Allow


  4. If the page is loaded properly, you will now be able to use the buttons provided in the sample.html file.

    • To verify that the connection was established over HTTPS, right click > Inspect element on the webpage and look in the console (at the top).

    • Ports 8181, 8282, 8383, and 8484 are HTTPS connections. Ports 8182, 8283, 8384, and 8485 are HTTP connections.


What next?

Now that QZ Tray is properly running, you can start integrating the code into your environment!

  1. Learn how to sign your messages to suppress all dialogue warnings:

  2. Learn the minimal code needed to print from your browser to your printer:

  3. Learn how to run QZ Tray as a dedicated service (print server):

Edit this page