Virtual Appliance Installation

Last Updated: April 07, 2026

The Vasion Virtual Appliance is the latest generation of our on-premises printer management platform. It functions like our SaaS solution but is self-contained in your private cloud behind your company's firewalls. This streamlined solution comes ready to install and includes a server operating system, web services, and network environment. Four main version releases each year include new features, fixes, and improvements in an easy-update system.

Installation Requirements

Minimum System Requirements

Resource usage may increase depending on configured features and user count. Use the recommendations below when creating your Virtual Appliance, but continue to monitor the CPU and RAM utilization and allocate additional resources as needed.

  • Four 3.5-4.0 GHz processors. Add two 3.5 GHz processors for each additional 15,000 users.
  • 16 GB RAM for up to 15,000 users.
    • Add 2 CPUs / 8 GB RAM for each additional 15,000 users.
    • Add a minimum of 2 CPUs and 4 GB RAM if using the Internal Service Client.
    • Add 2 CPUs and 4 GB RAM per 500 CPA / Simple Badge Release installations.
  • 160 GB free hard disk space for the host disk.
  • There should be 50 GB of free hard disk space on the persistent storage disk (add 4GB for every 100 printers).
  • NT LAN Manager (NTLM) v2 must connect to the Virtual Appliance's appliance-storage shared folder.

DNS Configured

  1. Identify a fully qualified domain name (FQDN) to use for the Virtual Appliance. (e.g., printerlogic.mycompany.com).
  2. Create an A record in Domain Name System (DNS) (i.e., printerlogic.mycompany.com) that points to the IP Address of the Virtual Appliance.
  3. Create a CNAME record in DNS (i.e., *.printerlogic.mycompany.com) that points to the A record above (i.e., printerlogic.mycompany.com).

SSL Certificates

Create the Secure Sockets Layer (SSL) certificate. The SSL certificate requires a signature from a public Certificate Authority (CA) or private CA trusted by the enterprise.

  • The SubjectAlternativeName extension must list the two DNS entries above. For example, printerlogic.mycompany.com and *.printerlogic.mycompany.com.

The following features require a publicly trusted CA.

  • IdP SCIM configurations
  • Vasion mobile app
  • Off-Network Print external gateways
  • Application Update button (Support & Training then About PrinterLogic)

You can spin up a Virtual Appliance without an SSL certificate, but functionality is limited, and many features will not work.

Vasion provides a downloadable tool to assist with formatting the certificates correctly. For more details refer to Virtual Appliance SSL Certificates.

Ports

The following ports must be opened for database access on the device managing your virtual machines.

  1. TCP 3306: MySQL
  2. TCP 80: HTTP
  3. TCP 443: HTTPS
  4. TCP 8000: Configuration Application Programming Interface (API)
  5. TCP 8080: Configuration User Interface (UI)
  6. TCP 445: Server Message Block (SMB)

Accessing Data Files

If you need to add or update a license file or certificate or access the log files, you will need to map a network drive to the Virtual Appliance folder share. Use a non-elevated command prompt similar to: net use V: \\<hostname>\appliance-storage <password> /user:Admin /p:yes.

If the password contains special characters you will need to place "quotes" around the password.

Make sure you use a non-elevated command prompt to map the drive. If you have Windows UAC enabled on your workstation, drives mapped from an elevated command prompt are not visible in Windows Explorer by default. You can find additional information in Microsoft documentation.

Compatibility Tables

Application & Host Compatibility Information (VMDK/VHD/OVA/QCOW2)

  • Customers on Host build 1.0.757 or older, please contact our support team to upgrade to the latest version.
  • Customers on Host build 22.0.818-22.0.913 must complete an incremental upgrade to 22.0.933 before upgrading further.
  • Customers on Host build 22.0.933-25.1.102 must complete an incremental upgrade to 25.1.116 before upgrading further.
  • Customers on 25.1.116 and later can upgrade to the most recent Host release.
VMDK/VHD/OVA/QCOW Compatibility Table

Application

Host

Release Date

Minimum Supported Host

MySQL Version Compatibility
(Min/Max)

Included Client Versions

26.1.1778

26.1.303

May 1st, 2026

26.1.301

8.0.42 / 8.0.45

Windows: 25.1.0.1367
Mac / Linux: 25.2.0.77

26.1.1763

26.1.301

April 27th, 2026

26.1.301

8.0.42 / 8.0.45

Windows: 25.1.0.1367
Mac / Linux: 25.2.0.77

25.3.1712

25.3.272

February 20, 2026

25.3.245

8.0.35 / 8.0.42

Windows: 25.1.0.1299
Mac / Linux: 25.2.0.73

25.3.1656

25.3.245

December 16, 2025

25.3.245

8.0.35 / 8.0.42

Windows: 25.1.0.1299
Mac / Linux: 25.2.0.69

25.2.1518

25.2.169

June 26, 2025

22.0.951

8.0.35 / 8.0.42

Windows: 25.1.0.1187
Mac / Linux: 25.2.0.51

25.1.1428

25.1.116

March 26, 2025

22.0.933

8.0.35 / 8.0.41

Windows: 25.1.0.1136
Mac / Linux: 25.2.0.16

25.1.1413

25.1.102

February 27, 2025

22.0.933

8.0.35 / 8.0.37

Windows: 25.1.0.1136
Mac / Linux: 25.2.0.16

20.0.2786

22.0.1049

December 23, 2024

22.0.893

8.0.35 / 8.0.37

Windows: 25.0.0.1074
Mac / Linux: 25.1.0.695

20.0.2702

22.0.1026

November 21, 2024

22.0.893

8.0.35 / 8.0.37

Windows: 25.0.0.1074
Mac / Linux: 25.1.0.695

20.0.2614

22.0.1002

October 22, 2024

22.0.893

8.0.35 / 8.0.37

Windows: 25.0.0.1071
Mac / Linux: 25.1.0.687

20.0.2592

22.0.951

October 2, 2024

22.0.893

8.0.35 / 8.0.37

Windows: 25.0.0.1071
Mac / Linux: 25.1.0.687

20.0.2489

22.0.951

August 19, 2024

22.0.893

8.0.35 / 8.0.37

Windows: 25.0.0.1034
Mac / Linux: 25.1.0.687

20.0.2368

22.0.933

May 30, 2024

22.0.818

8.0.30 / 8.0.35

Windows: 25.0.0.1025
Mac / Linux: 25.1.0.681

20.0.2253

22.0.913

February 28, 2024

22.0.818

8.0.26 / 8.0.30

Windows: 25.0.0.1000
Mac / Linux: 25.1.0.666

20.0.2140

22.0.893

December 1, 2023

22.0.818

8.0.26 / 8.0.30

Windows: 25.0.0.973
Mac / Linux: 25.1.0.653

20.0.2014

22.0.862

September 28, 2023

1.0.757

8.0.26 / 8.0.30

Windows: 25.0.0.939
Mac / Linux: 25.1.0.642

20.0.1923

22.0.843

June 23, 2023

1.0.750

8.0.26 / 8.0.30

Windows: 25.0.0.917
Mac / Linux: 25.1.0.637

20.0.1766

22.0.818

March 17, 2023

1.0.742

8.0.26 / 8.0.30

Windows: 25.0.0.864
Mac / Linux: 25.1.0.626

20.0.1708

22.0.818

January 20, 2023

1.0.674

8.0.26 / 8.0.30

Windows: 25.0.0.802
Mac / Linux: 25.1.0.612

20.0.1682

22.0.818

January 10, 2023

1.0.674

8.0.26 / 8.0.30

Windows: 25.0.0.791
Mac / Linux: 25.1.0.610

20.0.1582

1.0.757

September 29, 2022

1.0.674

 

Windows: 25.0.0.734
Mac / Linux: 25.1.0.604

20.0.1533

1.0.757

August 18, 2022

1.0.674

 

Windows: 25.0.0.693
Mac / Linux: 25.1.0.597

20.0.1510

1.0.757

July 29, 2022

1.0.674

 

Windows: 25.0.0.673
Mac / Linux: 25.1.0.592

20.0.1480

1.0.756

June 27, 2022

1.0.674

 

Windows: 25.0.0.658
Mac / Linux: 25.1.0.586

20.0.1442

1.0.750

May 18, 2022

1.0.674

 

Windows: 25.0.0.639
Mac / Linux: 25.1.0.574

Application & Host Compatibility Information (AMI)

AMI Compatibility Table

AMI Version

Application Version

Release Date

Included Client Versions

26.1.303

26.1.1778

May 1st, 2026

Windows: 25.1.0.1367
Mac / Linux: 25.2.0.77

26.1.301

26.1.1763

April 27th, 2026

Windows: 25.1.0.1367
Mac / Linux: 25.2.0.77

25.3.272

25.3.1712

February 20, 2026

Windows: 25.1.0.1299
Mac / Linux: 25.2.0.73

25.3.245

25.3.1656

December 16, 2025

Windows: 25.1.0.1299
Mac / Linux: 25.2.0.69

25.2.169

25.2.1518

June 26, 2025

Windows: 25.1.0.1187
Mac / Linux: 25.2.0.51

25.1.116

25.1.1428

March 26, 2025

Windows: 25.1.0.1136
Mac / Linux: 25.2.0.16

25.1.102

25.1.1413

February 27, 2025

Windows: 25.1.0.1136
Mac / Linux: 25.2.0.16

24.4.66

20.0.2786

December 23, 2024

Windows: 25.0.0.1074
Mac / Linux: 25.1.0.695

1.0.712

20.0.2702

November 21, 2024

Windows: 25.0.0.1074
Mac / Linux: 25.1.0.695

1.0.671

20.0.2614

October 22, 2024

Windows: 25.0.0.1071
Mac / Linux: 25.1.0.687

1.0.587

20.0.2489

August 19, 2024

Windows: 25.0.0.1034
Mac / Linux: 25.1.0.687

1.0.537

20.0.2368

May 30, 2024

Windows: 25.0.0.1025
Mac / Linux: 25.1.0.681

1.0.498

20.0.2253

February 28, 2024

Windows: 25.0.0.1000
Mac / Linux: 25.1.0.666

1.0.466

20.0.2140

December 1, 2023

Windows: 25.0.0.973
Mac / Linux: 25.1.0.653

1.0.433

20.0.2014

September 28, 2023

Windows: 25.0.0.939
Mac / Linux: 25.1.0.642

1.0.409

20.0.1923

June 23, 2023

Windows: 25.0.0.917
Mac / Linux: 25.1.0.637

1.0.368

20.0.1766

March 17, 2023

Windows: 25.0.0.864
Mac / Linux: 25.1.0.626

1.0.350

20.0.1708

January 20, 2023

Windows: 25.0.0.802
Mac / Linux: 25.1.0.612

1.0.276

20.0.1533

August 18, 2022

Windows: 25.0.0.693
Mac / Linux: 25.1.0.597

1.0.265

20.0.1510

July 29, 2022

Windows: 25.0.0.673
Mac / Linux: 25.1.0.592

Installation Topics