Documentation

FAQ
Code Examples
Pixel Printing
Raw Printing
Communication
Network Information Data Filtering Getting Started Using QZ Tray Signing Messages API Overrides Command Line Usage
Licensing/Renewing
Generate Certificate Certificate Renewal Company Branded Signing Messages General Licensing Information
Printer Emulators
Deployment Options
Print Server Deployment Multiple Instances Windows Service Headless Operation Unattended Deployment Custom Provisioning Client Side Substitutions
Configure Raw Printer
Windows Ubuntu Linux macOS
Compiling
Install Dependencies Compile (QZ Tray)

Headless

Compatibility

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

Objective

Prerequisites

  • A Certificate (digital-certificate.txt if generated from our portal)

    Note: Step 2 of the signing messages tutorial needs to be completed in order to establish a websocket connection

Steps

  1. Whitelist the certificate

    The first step is to whitelist the Certificate your signatures will be authenticating against. You can launch the software prior to this, but you will not be able to make a websocket connection, as there is no GUI for the warning dialogues to display in, causing an immediate disconnect.

    • Open a terminal or cmd prompt and execute the appropriate command for your OS:

      Note: the --whitelist flag can be substituted with --allow or -a

      OS Command
      Windows "%PROGRAMFILES%\QZ Tray\qz-tray-console.exe" --whitelist "path\to\digital-certificate.txt"
      ... and optionally copy "%appdata%\qz\allowed.dat" "%programdata%\qz\allowed.dat" see also #749.
      Linux /opt/qz-tray/qz-tray --whitelist "path/to/digital-certificate.txt"
      macOS "/Applications/QZ Tray.app/Contents/MacOS/QZ Tray" --whitelist "path/to/digital-certificate.txt"

    • Verify the entry Successfully added YOUR COMPANY to allowed list in the log displayed in the command prompt

    • An allowed.dat file is created with the finger print of the Intermediate Certificate (digital-certificate.txt).

      User Scope

      OS Location
      Windows %APPDATA%\qz\allowed.dat
      Linux ~/.qz/allowed.dat
      macOS "~/Library/Application Support/qz/allowed.dat"

      System Wide

      OS Location
      Windows %PROGRAMDATA%\qz\allowed.dat
      Linux /srv/qz/allowed.dat
      macOS "/Library/Application Support/qz/allowed.dat"

  2. Launch QZ Tray in headless mode

    • Run the software from the command line using the --headless or -h flag:

      OS Command
      Windows "%PROGRAMFILES%\QZ Tray\qz-tray-console.exe" --headless
      Linux /opt/qz-tray/qz-tray --headless
      macOS "/Applications/QZ Tray.app/Contents/MacOS/QZ Tray" --headless
Edit this page