Documentation
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.
- For white-label customers, replace
-
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.