qz | Deployment

FAQ

Code Examples

Overview HTML Printing PDF Printing Image Printing Advanced Pixel Printing

Overview Raw Encoding ZPL EPL ESC/POS ESC/P DPL PGL SBPL

Printer Status File Communication HID Communication Serial 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

Configure Raw Printer

Windows Ubuntu Linux macOS

Compiling

Install Dependencies Compile (QZ Tray)

Deployment

Compatibility

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

Objective

Perform a silent, unattended or slipstream installation of QZ Tray, such as in a corporate environment.

Steps

Windows

We use NSIS (Nullsoft Scriptable Installer System) for Windows.

Install silently to the default location (run Command Prompt as Administrator)
```
start /wait "" qz-tray-2.x.x.exe /S
```
Install silently to a non-standard location (run Command Prompt as Administrator)
```
start /wait "" qz-tray-2.x.x.exe /S /D=C:\Program Files\QZ Tray
```

Linux

We use Makeself for Linux.

Install silently to the default location
```
sudo bash qz-tray-2.x.x.run -- -y
```

Mac

We can use the installer command on Mac to silently install QZ Tray via the command line. Type (or click here): man installer on the command line for more examples.

Install silently to the default location

sudo installer -pkg qz-tray-2.x.x.pkg -target /

Install silently to a non-standard location

Note: Use at your own risk; Non-standard install locations are currently not supported.
```
sudo installer -pkg qz-tray-2.x.x.pkg -target /Alternate/Volume
```

Uninstall

Windows Uninstall

We use NSIS (Nullsoft Scriptable Installer System) for Windows.

Uninstall silently

start /wait "" "%programfiles%\QZ Tray\uninstall.exe" /S

Linux Uninstall

Uninstall silently
```
sudo bash /opt/qz-tray/uninstall
```

Mac Uninstall

Uninstall silently

# 2.2+
sudo bash /Applications/QZ\ Tray.app/Contents/Resources/uninstall

# 2.1 and older
sudo /Applications/QZ\ Tray.app/Contents/uninstall

Automatic Start

Automatic start steps (legacy versions only)

QZ Tray 2.1+

QZ Tray 2.1 and higher will automatically start at login, no steps are needed.

QZ Tray 2.0

For versions 2.0 and older, the user must click "Automatically start" in the tray icon, which may not be desired for corporate environments.

There are several methods for making an application launch automatically on various desktops, however to mimic the technique used by QZ Tray 1.9 - 2.0 is:

Windows Automatic Start

First, uncheck "Automatically start" and close QZ Tray.
Run the following command through a Command Prompt window. Administrative access is not required.
```
reg.exe add HKCU\Software\Microsoft\Windows\CurrentVersion\Run\ /v "QZ Tray" /d "%programfiles%\QZ Tray\qz-tray.exe" /f
```
- For white-label customers, replace QZ Tray with the name of your application, e.g. Acme Printing, etc.
Re-launch QZ Tray and verify the "Automatically start" option has been reselected.
To secure this change (user cannot disable) requires modifying registry permissions using regini and a separate .reg file which can have other negative side-effects and is out of scope of this tutorial.

Edit this page

Documentation