Application Update

Last Updated: January 07, 2026

The Virtual Appliance has two parts that can be upgraded or updated, the Host build and the Application build. The steps below cover two methods of updating the Virtual Appliance application build. For steps to upgrade the Host build, reference Host Upgrade.

Requirements

  • Virtual Appliance Host and Application files are no longer available on the Admin Guide site. To obtain these files please create a support ticket with our team and include:
    • Latest Host / Application Files Request in the subject field.
    • Your current Host and Application versions (Support & Training then About PrinterLogic) in the description.
    • Hypervisor file type (GPG, OVA, VMDK, VHD, QCOW2) in the description.
  • Review the Minimum System Requirements for environmental specifics and version compatibility before upgrading your versions.
  • Note the network information of the existing Virtual Appliance. Upgrades require the information re-entered as network settings do not carry over during an upgrade.

Key Points

  • There are two options for updating the Application layer, using the Update Now button on Support & Training then About PrinterLogic or manually applying the .gpg file.

  • Application version 25.3.1656 is only available by upgrading to Host version 25.3.245 and is not an update option for previous Host versions. Selecting the Update Now button in the console while on a previous Host build will not update the Application to this version.

  • If your Virtual Appliance is not using a Secure Sockets Layer (SSL) certificate, the Update Now button will not work.
  • Updating the Application build on an unsupported Host version may break your Virtual Appliance.

Backup the Virtual Appliance

Before upgrading the Virtual Appliance, it is crucial to back up the database. Failure to do so can result in irreversible data loss. For more information on comprehensive backup guidelines, see Database Backup Recommendations.

Application Update

Automatic Update

The automatic update downloads the package from our online update service over TCP 443. If there is no response when using the Update Now button, verify the Virtual Appliance's Domain Name System (DNS) and SSL requirements are in place.

  1. In the Admin Console, go to Support & Training then About PrinterLogic.
  2. Verify your current Host build is compatible with the available Application version in the Compatibility Tables.
  3. If on a compatible version, select the Update Now button.
  4. Allow a few minutes for the process to complete.

Manual Update

  1. In the Admin Console, go to Support & Training then About PrinterLogic.
  2. Verify your current Host build is compatible with the available Application version in the Compatibility Tables.
  3. If on a compatible version, create a support ticket with our team to acquire the Application file.
    1. Download the file in a place accessible by your Virtual Appliance.
  4. Connect to the Virtual Appliance share drive.

  5. Open the .updates folder and place the downloaded .gpg file in the folder.

    If the .updates folder does not exist, create one. Please ensure you can view hidden folders. Creating a duplicate .updates folder can cause the update to fail.

  6. Right-click in the .updates folder and select New then Text Document.
    1. Name that document .update.txt.
  7. Edit the .update.txt file.
    1. Enter the version number you are updating to; it will match the beginning portion of the .gpg file (example: 20.0.1305).
  8. Select File then Save As.
    1. Change the Save As type to All Files.
    2. Name the file .update.ready
    3. Verify the file Type column for the file (.update.ready) shows as READY File.
  9. Rename the file to .update

    1. Verify the file Type column for the file (.update) shows as UPDATE File.

      You can ignore the LOCK File.

  10. Once the file is saved as an UPDATE File, the Virtual Appliance will start automatically updating using the .gpg file. To confirm the update progress, open the virtual machine web console for the Virtual Appliance and you will see STATUS: updating. Once the update is complete, you will see STATUS: running.

Verify the Update

  1. Verify the update was successful by logging into the Admin Console
  2. Go to Support & Training then About PrinterLogic to verify the Application version number matches the version you just updated to.
  3. Remove the .gpg file from the .updates folder once the update is confirmed complete.