2.1 Headless

Compatibility

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

Objective

• Run QZ Tray in a headless environment

Steps

1. Windows
2. Linux
3. macOS

Windows

Launch in Headless Mode

1. Run the software from the cmd prompt:

java -jar "%PROGRAMFILES%\QZ Tray\qz-tray.jar" --headless

A connection will automatically be rejected because the normal warning dialogue cannot be displayed. The certificate must be whitelisted prior to use.

Whitelist the Certificate

1. Open a new cmd prompt or "CTRL + C" to close the software

java -jar "%PROGRAMFILES%\QZ Tray\qz-tray.jar" --whitelist "path\to\digital-certificate.txt"

• An allowed.dat file is created under %APPDATA%\qz

1. Check for Successfully added YOUR COMPANY to allowed list

• You should then be able to successfully establish the websocket connection

###Linux

Launch in Headless Mode

1. Run the software from the terminal prompt:

java -jar /opt/qz-tray/qz-tray.jar --headless

A connection will automatically be rejected because the normal warning dialogue cannot be displayed. The certificate must be whitelisted prior to use.

Whitelist the Certificate

1. Open a new terminal prompt or "CTRL + C" to close the software

java -jar /opt/qz-tray/qz-tray.jar --whitelist 'path\to\digital-certificate.txt'

• An allowed.dat file is created under /home/user/.qz/

1. Check for Successfully added YOUR COMPANY to allowed list

• You should then be able to successfully establish the websocket connection

###macOS

Launch in Headless Mode

1. Run the software from the terminal prompt:

java -jar /Applications/QZ\ Tray.app/qz-tray.jar --headless

A connection will automatically be rejected because the normal warning dialogue cannot be displayed. The certificate must be whitelisted prior to use.

Whitelist the Certificate

1. Open a new terminal prompt or "CTRL + C" to close the software

java -jar /Applications/QZ\ Tray.app/qz-tray.jar --whitelist 'path\to\digital-certificate.txt'

• An allowed.dat file is created under /Users/user/Library/Application\ Support/qz/

1. Check for Successfully added YOUR COMPANY to allowed list

• You should then be able to successfully establish the websocket connection