What is minimum system requirements for QZ Tray software?

*HTML printing in QZ Tray 2.x requires Java 8 + Java FX.

Version 2.0 or higher requires 512MB of free memory (RAM), recommends 6GB or higher total system memory for raster graphics.

*Safari 5.1.7 is bundled with Lion but is not supported. Alternate browser required.
*Windows XP requires manual certificate installation. Will prompt at install time.

* Firefox requires a browser restart for HTTPS
* IE/Edge on domain networks require external DNS access to localhost.qz.io due to a Local Intranet Limitation.

The following applications may cause issues with QZ Tray installation.

• Older Java versions: QZ Tray works best with Java 11 or higher. Older QZ Tray versions may conflict with QZ Tray and cause it to fail to start.

  • If possible, uninstall all versions of Java, JRE, JDK or OpenJDK from the system.
  • If uninstalling old versions of Java is not possible, install QZ Tray 2.2 or higher, which will come bundled with its own Java version.

• Antivirus Software: Some antivirus applications may prevent QZ Tray from installing or running.

  • Comodo Antivirus will force application containment the QZ Tray installer and prevent it from being installed, uninstalled and prevent it from running. Moreover, disabling Comodo will have very little effect because it will re-enable itself without warning. QZ Tray is not supported with Comodo Antivirus.

• Other Antivirus:

  • Application containment: If the antivirus forces application containment, please disable this application containment for QZ Tray and the Java Runtime which it uses.
  • Web Filtering: If the antivirus blocks access to local ports or localhost certificates, please disable or whitelist https://localhost:8181, http://localhost:8182.
  • Temporary File Access: If the antivirus blocks access to the temporary directory, please disable or whitelist the QZ Tray installer.
  • Other issues: QZ Industries does not provide support for issues created by third party antivirus applications. Built-in features (such as Windows Defender) are supported and may be escalated to the various support channels.

• If QZ Tray fails to install with the error "Sorry, this version of QZ Tray cannot be installed on this system"
  • This could be caused by mismatched architecture. QZ Tray is only supported on 64-bit Intel and 64-bit ARM/Apple Silicon. Please ensure the version you are installing matches your architecture.
  • This could be caused on Windows if the username has not ANSI-characters in the username. For example, Sørina may cause the installer to fail, whereas Sorina will succeed. This is a limitation of Java, but a workaround is available in issue #1095.
  • This could be caused on Windows if the username has an exclamation mark in it. For example, Lenovo! may cause the installer to fail, whereas Lenovo will succeed. This is a limitation of Java. No workaround is available, the software must be installed using a different user account without the exclamation mark.
  • This could be caused on a computer running a 32-bit operating system. No workaround is available. Older 2.1 versions may work with 32-bit Java runtimes, but this configuration is not officially supported.

• To automatically retrieve the logs:
  • From the QZ Tray Icon:
    Advanced, Troubleshooting, Zip Logs (To Desktop)
    (They will be placed on the Desktop in a ZIP file)
    
    
• To manually retrieve the logs:
  QZ Tray places log files in the following locations:
  • Windows: %APPDATA%\qz
  • Mac: ~/Library/Application Support/qz
  • Linux: ~/.qz

• The recommended approach for getting verbose output from QZ Tray is to launch the software from command line. This will expose the Java Console with detailed information about debug messages and exceptions including full backtrace of where a particular exception occurred.

• QZ Tray launches with 512MB of memory. We must specify -Xms512M in the command in order to prevent unexpected behavior and crashing. This unnecessary for Mac unless following the basic syntax (java -jar qz-tray.jar) . More memory can be allocated but should not be necessary.

  Basic syntax (after closing all instances of QZ Tray)

  java -Xms512M -jar qz-tray.jar

  Windows (after closing all instances of QZ Tray)

  "%PROGRAMFILES%\QZ Tray\qz-tray-console.exe"
  REM or for 2.1 and older: java -Xms512M --add-exports java.desktop/sun.swing=ALL-UNNAMED -jar "%PROGRAMFILES%\QZ Tray\qz-tray.jar"