PRINT
EZZ.V2
SETUP_INSTRUCTIONS WSL2 // CUPS

SETUP GUIDE

Windows Installation & Provisioning

Step 1 — Download & Install the App

  • 1.1 Download one of the installers below. MSI is the standard Windows installer; the NSIS/exe versions are portable setup executables — either works.
  • 1.2 Run the installer and complete the Printezz Admin installation on your Windows machine.

Binary Downloads

Windows Installer (MSI) — win_printezz_admin/bundle/msi Download
Windows Setup (NSIS) — win_printezz_admin/bundle/nsis Download
Binary Executable — windows_bin Download
Exe Installer — windows_bin Download

Step 2 — Automated Setup (Recommended)

  • 2.1 Launch the Printezz Admin app and log in with your credentials.
  • 2.2 On the first-run System Setup screen, click Run Setup.
  • 2.3 The wizard automatically: detects your OS → installs WSL2 → installs cups-filters inside WSL → verifies the pipeline.
  • 2.4 If prompted, approve the Administrator elevation request. A reboot may be required after WSL installation.

Step 3 — Manual Installation (If Automated Setup Fails)

3.1 Install WSL2

Open PowerShell as Administrator and run:

# Install WSL with default Ubuntu distribution wsl --install # Or specify a distribution wsl --install -d Ubuntu-22.04

If wsl --install is unavailable, enable the required features manually:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # --- Restart your computer, then --- wsl --set-default-version 2 wsl --install -d Ubuntu

3.2 Reboot

After WSL installation completes, reboot your computer.

3.3 Install cups-filters inside WSL

Open Ubuntu (WSL) from the Start menu and run:

# Update the package list sudo apt-get update # Install cups-filters sudo DEBIAN_FRONTEND=noninteractive apt-get install -y cups-filters # Verify the installation cupsfilter --version

3.4 Verify from Windows

Back in PowerShell, confirm WSL can see the binary:

# Should output something like: cupsfilter (cups-filters) 1.28.17 wsl cupsfilter --version

Step 4 — Verify Installation

  • 4.1 Launch the Printezz Admin app.
  • 4.2 Click Run Setup — both checks should show green:
      ✅ WSL2 Runtime
      ✅ CUPS Filters

Or verify manually:

# Check WSL version wsl --status # Check cupsfilter inside WSL wsl command -v cupsfilter

Step 5 — Troubleshooting

Symptom Resolution
"WSL 2 requires an update to its kernel component" Run wsl --update in Administrator PowerShell
"Virtualization not enabled" Enable Virtualization (VT-x/AMD-V) in BIOS/UEFI
WSL install error 0x80070003 Update Windows, then retry wsl --install
"Could not get lock /var/lib/dpkg/lock-frontend" Close other apt processes, wait, retry
"No installation candidate for cups-filters" Run sudo apt-get update first
Permission denied during install Prefix commands with sudo
< Back to Home