Client Setup & Printer Daemon Installation

Download Installer Package

If a recent client build was produced, you can download the packaged archive here:

Download liderit-printer-client.zip

Prerequisites

Windows Workstations

• Windows 10 or newer
• At least one printer installed locally
• Administrator access for installation
• SumatraPDF recommended for silent PDF printing
• Microsoft Word or compatible application for .doc/.docx printing

Linux Workstations

• Any modern Linux distribution
• CUPS (Common Unix Printing System) installed and configured
• At least one printer added to CUPS
• LibreOffice installed for .doc/.docx printing
• sudo or root access for installation

Connection Requirements

• Network access to the Liderit Panel
• Outbound access to port 14545 (mTLS connection)

Step 1: Get Your Client Credentials from the Panel

Your system administrator must register your workstation in the Liderit Panel first. Once registered, you'll receive:

• Client Key — a unique name (e.g., office-pc-01)
• Panel URL — the Liderit panel address (for status checks)
• Certificate bundle — client.crt, client.key, ca.crt provided by admin

Step 2: Receive Your SSL Certificate Bundle

The Printer Daemon uses secure SSL/TLS certificates for encryption. Certificates are issued and delivered by an administrator. Client installers do not issue or download certificates.

Required Files

1. Ask your administrator for the client certificate bundle
2. Extract the bundle and verify it contains:
   • client.crt — your certificate
   • client.key — your private key (keep secure!)
   • ca.crt — the Certificate Authority certificate
3. During installation, the installer will ask you for cert_dir and each filename separately, then write those values into [tls] in your config.toml
4. Default values are: cert_dir = "./certs", cert_file = "client.crt", key_file = "client.key", ca_file = "ca.crt"
5. The installer will then ask where the source certificate files currently exist, verify all three files are present, and stop installation if any are missing
6. If all files exist, the installer creates the target certificate folder if needed and copies the files there before finishing installation
7. The installer also asks for core runtime settings and writes them into config with defaults:
   • server.address = "api.liderit.ro:14545"
   • server.client_key (required value)
   • server.reconnect_interval = "5s"
   • storage.transfer_dir = "./transfers"
   • storage.temp_dir = "./tmp"
   • cleanup.after_print = true
   • cleanup.after_transfer = false

Step 3: Install the Printer Daemon

Windows Installation

1. Download installer: Get the Windows installer from your administrator
2. Open PowerShell as Administrator: Right-click PowerShell and select "Run as administrator"
3. If PowerShell blocks script execution: Run the installer with execution policy bypass PowerShell -ExecutionPolicy Bypass -File ".\install-windows.ps1"
4. Run the installer: Execute one of the following commands

   Run installer:

   .\install-windows.ps1
5. Review certificate paths: The installer will ask for the certificate folder plus the filenames for client.crt, client.key, and ca.crt
6. Review printer selection: The installer will show all local printers and ask you which ones to include
7. Installation complete: The Printer Daemon service is installed and starts automatically

Linux Installation

1. Download installer: Get the Linux installer from your administrator
2. Make executable: chmod +x install-linux.sh
3. Run the installer: Execute one of the following commands

   Run installer:

   sudo ./install-linux.sh
4. Review certificate paths: The installer will ask for the certificate folder plus the filenames for client.crt, client.key, and ca.crt
5. Review printer selection: The installer will show all local CUPS printers and ask which ones to include
6. Installation complete: The Printer Daemon service is installed and starts automatically

Step 4: Connect to the Panel

Once the Printer Daemon is installed and running, it automatically connects to the Liderit server using the credentials provided during installation.

Verify Connection

You can verify your connection is working by checking:

Windows:

1. Open Services (services.msc)
2. Find "LideritPrinter" and verify it's running
3. Check Event Viewer for any connection errors

Linux:

systemctl status liderit-printer journalctl -u liderit-printer -f

Panel Status Check

1. Log in to the Liderit Panel
2. Go to Clients
3. Find your client — if connected, it will show as Online
4. Click on your client to see registered printers

Sending Files to Print

Once your Printer Daemon is online, your administrator can send files to your workstation for printing through the Liderit API.

Supported File Types

• .pdf — sent to default printer or specified printer
• .doc / .docx — opened with associated application and printed
• .xls / .xlsx — opened with associated application and printed
• .txt — sent to default printer
• Other formats — depends on system associations

Printer Selection

During installation, you selected which printers to register. Your administrator can:

• Send files to your default printer
• Target a specific printer by its registered name
• Specify number of copies

Managing the Printer Daemon

Windows Service Management

Start/Stop from Services:

• Open Services (services.msc)
• Find LideritPrinter
• Right-click → Start/Stop/Restart

From PowerShell (Admin):

Start-Service LideritPrinter Stop-Service LideritPrinter Restart-Service LideritPrinter Get-Service LideritPrinter

Linux Service Management

sudo systemctl start liderit-printer sudo systemctl stop liderit-printer sudo systemctl restart liderit-printer sudo systemctl status liderit-printer

View logs:

sudo journalctl -u liderit-printer -f

Uninstall

Windows:

.\bin\printer.exe -uninstall

Linux:

sudo ./uninstall-linux.sh