Linux & domestic OS deployment

Deploy the Web Print Expert client on Kylin, UOS, Ubuntu, Debian, and more; integrate web-print-pdf for web printing and HTML to PDF.

Platform editions

EditionPlatformPrint backendInstaller
WindowsWindows 10/11Built-in silent print engine.exe installer
Linuxx64 / arm64System print service.deb / .rpm
macOSmacOS 11+CUPS.dmg

Windows and Linux ship as separate installers but share the same WebSocket API (/websocket/standard)—front-end code stays platform-agnostic.

End-user deb install

  1. Download the Linux deb from the download page.
  2. On Kylin / UOS: double-click the deb or run sudo dpkg -i.
  3. Launch the client, complete setup, and verify the local print service.
  4. npm install web-print-pdf—same APIs as on Windows.
# CLI install example
sudo dpkg -i WebPrintExpert_*_amd64.deb
sudo apt-get install -f    # fix dependencies

# Launch (from menu or CLI after install)
ItemDescription
Install methodDouble-click deb or dpkg -i
Install locationSystem applications folder (configured by the package)
LaunchDesktop menu “Web Print Expert” or app shortcut
ArchitectureSeparate deb packages for x64 / amd64 and arm64

System dependencies (deb)

The Linux installer declares runtime dependencies, typically including:

  • System print client libraries — required for silent printing on Linux
  • GUI and font rendering runtime libraries
  • Install common CJK font packages to avoid missing glyphs in PDF or print output
If print services or system libraries are missing, the client opens an in-app guide—no Node.js required for end users.

Building Linux packages (advanced)

For custom builds: obtain the project sources and follow the bundled packaging guide.

# Typical flow (see project docs for exact commands)
1. Install build deps and frontend toolchain
2. Clone source and install project dependencies
3. Run Linux packaging (deb / rpm)
4. Install and verify on target system

Typical steps: prepare front-end assets → verify layout engine and system libs → produce deb/rpm packages.

RPM builds need extra system packaging tools; see the project documentation for commands.

Cross-platform print overview

HTML→PDF uses the client’s built-in layout engine; output is handed to each platform’s print stack:

  • Windows: client silent print engine → system print queue
  • Linux: system print service for silent output

Front-end still passes printOptions.printerName; printer lists are normalized by the client API.

Notes

  • Share one front-end print codebase across Linux and Windows endpoints.
  • deb install needs root; runtime can use a normal user.
  • Works offline on intranet; PDF generation is local.
  • Linux clients support updates via architecture-specific update descriptors.
Download client free Documentation