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

1. First, uncheck "Automatically start" and close QZ Tray.

2. 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.

3. Re-launch QZ Tray and verify the "Automatically start" option has been reselected.

   

4. 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.