Deploy the Client

Last Updated: April 07, 2026

This topic explains how to install the Client The Client is software that you install on a server or device that communicates with the Vasion Print server. The Client installs and manages printers, driver profiles, and other settings. on a device using scripts, which empowers IT teams to efficiently manage and scale software installation.

An end user device requires the Vasion Print Client to do the following:

  • Install printers on the device.
  • Install and update drivers on the device.
  • Collect print-job metadata for reports.
  • Hold print jobs in a print queue.
  • Release held print jobs to a printer.

There are several ways to install the Vasion Print Client on a device. Refer to OS Installation for instructions on how to manually install the Client.

There are also Client packages in the Admin Console that you can download and use with a Windows start-up script; third-party app, such as Microsoft Configuration Manager, Microsoft Intune, or Ivanti; or Group Policy Object (GPO) on a device with a supported Windows, macOS, or Linux operating system (OS).

We recommend using your organization's software-deployment tool.

Requirements

The following are the minimum device requirements for Client installation:

  • Client installation requires an OS with a minimum of 300MB of free hard disk space. Printer drivers might require additional space.
  • If you use an antivirus software, add the list of folders to exclude from antivirus scans. For more details refer to Antivirus Exclusions.
  • macOS devices using ARM processors may experience issues with some print drivers that lack native ARM support. Install Rosetta 2 for these print drivers to function correctly.
  • Windows devices using ARM processors are supported as of Windows Client version 25.1.0.1282.
    • C++ ARM64 must be installed on the ARM devices for the Client to function correctly.
    • Advanced features, such as Off-Network Print, Off-Network Cloud Print, Offline Secure Release Print, and Quota Management, are not supported on ARM devices.
    • Core features, such as Pull Print and Direct Secure Release, are supported.

Authorization Code

To authorize device communication between the Client and the Admin Console, you must include an authorization code in the installation script. Follow these steps to generate an authorization code:

  1. Open a web browser, and log in to the Admin Console.
  2. Navigate to Tools then Tokens then Authorized Devices or Tools then Authorized Devices, depending on your permissions.
  3. From the Code Expiration length dropdown menu, select the expiration length.

  4. Select Generate.

    Admin Console showing "Code Expiration length" menu and Generate button.

For more details refer to Device Authorization.

Client-Installation Package

Follow these steps to download the Client-installation package:

  1. In the Admin Console, go to Tools then Settings then Client.
  2. Scroll down to the Deployable Client Packages section.

  3. Select the file type for the desired package.

Client-Installation Scripts

  • Windows
  • macOS
  • Ubuntu
  • Red Hat

Use the command below to install the Client on a Windows device. The following are additional details:

  • The /qn command runs the installation silently.
  • You can copy the PrinterInstallerClient.msi to a different distribution point.
  • To install the Client in a multiuser environment, such as Remote Desktop Services (RDS) or Citrix Virtual Apps, you need to configure the Client on the server or image for RDS mode. For more details refer to Remote Desktop Services (RDS).

Run the following command in a command prompt:

Copy Code 
msiexec /i PrinterInstallerClient.msi /qn HOMEURL=https://<HOME_URL_HERE> AUTHORIZATION_CODE=<AUTH_CODE_HERE>

Replace <HOME_URL_HERE> with your instance's URL, and replace <AUTH_CODE_HERE> with your authorization code.

You can add the following parameter to control whether to install the PrinterLogic Extension with the Client. You can use the following options:

  • NOEXTENSION=0 This parameter overrides any previous setting and includes the extension.
  • NOEXTENSION=1 This parameter overrides any previous setting and excludes the extension.

Without the extension parameter, the command performs the same action as the last time the installer or uninstaller ran or whatever is already in the registry overrides.

Additional Client & Override Commands

Refer to Client Commands and Override Options for Windows for scripts and variables to further adjust the Client to better suit your environment.

A macOS device using an M1 chip must have Rosetta 2 installed for the Client to communicate correctly.

Do not use the Reset Printing System option in the Printers & Scanners tab on macOS because it can cause adverse behavior with the Client. For more details refer to Reset Printing System Option.

Save the PKG file in the /tmp file directory. If you have not downloaded the file yet, you can use this command:

Copy Code 
curl -o /tmp/PrinterInstallerClientSetup.pkg https://<HOME_URL_HERE>/client/setup/PrinterInstallerClientSetup.pkg

Replace <HOME_URL_HERE> with your instance's URL.

Use this command to install the Client:

Copy Code 
sudo installer -allowUntrusted -pkg /tmp/PrinterInstallerClientSetup.pkg -target / && sudo /opt/PrinterInstallerClient/bin/set_home_url.sh https <HOME_URL_HERE> && sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AUTH_CODE_HERE>

Replace <HOME_URL_HERE> with your instance's URL, and replace <AUTH_CODE_HERE> with your authorization code.

Additional Client & Override Commands

Refer to Client Commands and Override Options for Mac & Linux for scripts and variables to further adjust the Client to better suit your environment.

We recommend using the latest version of Common UNIX Printing System (CUPS) printer to successfully install the Client.

The installation commands below support Ubuntu (LTS) 22.04 and 24.04.

  1. Get the Client install DEB file from the server:

    Copy Code
    64 bit
    wget https://<HOME_URL_HERE>/client/setup/printerinstallerclient_amd64.deb

    Replace <HOME_URL_HERE> with your instance's URL.

  2. Install the Client, set the home URL, and authorize the Client with the following command:

    Copy Code
    64 bit
    sudo apt update && sudo apt install -y printerinstallerclient_amd64.deb
    sudo /opt/PrinterInstallerClient/bin/set_home_url.sh https <HOME_URL_HERE> && sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AUTH_CODE_HERE>

    Replace <HOME_URL_HERE> with your instance's URL, and replace <AUTH_CODE_HERE> with your authorization code.

Additional Client & Proxy Override Commands

Refer to Client Commands and Override Options for Mac & Linux for scripts and variables to further adjust the Client to better suit your environment.

Common UNIX Printing System (CUPS) is required if you are using Pull Print and Direct Secure Release.

Red Hat 8

  1. Get the Client install RPM file from the server:

    Copy Code 
    wget https://<HOME_URL_HERE>/client/setup/printerinstallerclient_rhel8.rpm

    Replace <HOME_URL_HERE> with your instance's URL.

  2. Install the Client, set the home URL, and authorize the Client with the following command:

    Copy Code
    64 bit
    sudo yum localinstall -y printerinstallerclient_rhel8.rpm && sudo /opt/PrinterInstallerClient/bin/set_home_url.sh https <HOME_URL_HERE> && sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AUTH_CODE_HERE>

    Replace <HOME_URL_HERE> with your instance's URL, and replace <AUTH_CODE_HERE> with your authorization code.

Red Hat 9

  1. Get the Client install RPM file from the server:

    Copy Code 
    wget https://<HOME_URL_HERE>/client/setup/printerinstallerclient_x86_64.rpm

    Replace <HOME_URL_HERE> with your instance's URL.

  2. Install the Client, set the home URL, and authorize the Client with the following command:

    Copy Code
    64 bit
    sudo dnf install -y printerinstallerclient_x86_64.rpm && sudo /opt/PrinterInstallerClient/bin/set_home_url.sh https <HOME_URL_HERE> && sudo /opt/PrinterInstallerClient/bin/use_authorization_code.sh <AUTH_CODE_HERE>

    Replace <HOME_URL_HERE> with your instance's URL, and replace <AUTH_CODE_HERE> with your authorization code.

Additional Client & Proxy Override Commands

Refer to Client Commands and Override Options for Mac & Linux for scripts and variables to further adjust the Client to better suit your environment.

Write-Filter Systems

Installing the Client on write-filter devices might cause an infinite reboot loop because the Client attempts to reboot the device as part of its check-in. This issues occurs specifically when the Client attempts to turn off or turn on the write filter to install printers.

If you experience this issue, do the following:

  1. In the Admin Console, go to Tools then Settings then Client.
  2. Scroll down to the Write Filter Settings section.
  3. Select Disable clients installed with write filter support.
  4. Select Save in the upper-right corner.

The Vasion Print Client is highly customizable. To learn more about Client options, refer to the following:

Troubleshooting Help