Client Setup & Daemon Installation

Complete guide to install and configure the Liderit Daemon on your workstation

Before you begin: This guide is for the Liderit daemon client only. You'll need a Liderit account to access the Panel and generate the certificates required for installation. You can register at api.liderit.ro/panel.

Prerequisites

Windows Workstations

Linux Workstations

Connection Requirements

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:

Contact your administrator if you don't have these details yet. They can create a new client entry in the Panel → Clients section.

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 — if true, the saved file is deleted after a successful non-print transfer (including after any rule move)
  8. Optional storage rules for non-print files are not written by the installer by default; you can add them later in config.toml or (Windows) via the tray config editor — see File transfers & storage rules below.

Step 3: Install the Printer Daemon

Windows Installation

  1. Download the installer: Your administrator provides liderit-connector-setup.exe (or download it from the Panel when a connector release is published).
  2. Run as Administrator: Right-click liderit-connector-setup.exeRun as administrator and follow the wizard (certificates, server address, client key, printers, paths).
  3. Config location: After install, the daemon config is typically at %LOCALAPPDATA%\LideritConnector\config.toml (unless the service was installed with a custom -config path).
  4. Tray config editor (optional): If connector-tray.exe runs from the notification area, right-click → Edit Config… to change server settings, Storage (transfer folder, temp folder, routing rules), printers, logging, and SMS. Use Save & Reload so the service reloads the config.
  5. Installation complete: The Liderit Connector service is installed and starts automatically.
Developers / scripted install: A PowerShell helper install-windows.ps1 may still exist in some source bundles for automation only; normal end-user install is the .exe above.

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
Service Status: After installation, the daemon runs in the background automatically. You can check its status:

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-connector journalctl -u liderit-connector -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
Troubleshooting: If your client shows as offline, check:

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

Printer Selection

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

File transfers (non-print) & storage rules

When the API sends a job as a file transfer (not a print job), the daemon writes the file to [storage].transfer_dir (or to temp_dir if transfer_dir is empty). Directories are created if they do not exist.

Optional routing after save

You can define one or more storage rules so that, after the file lands in transfer_dir, it is moved into another folder when its base filename matches. This only applies to non-print transfers.

Rule types (ruleId)

ruleId Match type ruleMatch means
1 Starts with Filename begins with this literal string (case-sensitive).
2 Ends with Filename ends with this literal string (case-sensitive).
3 Contains Filename contains this substring (case-sensitive).
4 Regex Entire filename must match this Go regular expression.
5 Extension File extension equals ruleMatch; you may include or omit the leading dot; comparison is case-insensitive (e.g. ruleMatch of .pdf or pdf matches report.PDF).

Configuration in config.toml

Define each rule as [[storage.rules]] with the same three fields. Canonical keys:

[storage] transfer_dir = "./transfers" temp_dir = "./tmp" [[storage.rules]] ruleId = 1 ruleMatch = "INV_" ruleLocation = "./transfers/invoices" [[storage.rules]] ruleId = 5 ruleMatch = ".pdf" ruleLocation = "./transfers/pdf"

For compatibility, the same three fields may use legacy snake_case names (one block shown here; every [[storage.rules]] entry can use either style):

[[storage.rules]] rule_id = 1 rule_match = "INV_" rule_location = "./transfers/invoices"

Windows: edit without touching the file

Open the connector system tray menu → Edit Config…Storage tab. Set transfer_dir, temp_dir, and use Add / Edit / Remove for rules (same ruleId types as in the table). Click Save & Reload so the service reloads the config.

Linux / macOS

Edit config.toml with a text editor, then restart the service (e.g. sudo systemctl restart liderit-connector) or use your deployment’s reload procedure so the daemon reloads configuration.

cleanup.after_transfer: When set to true, the daemon deletes the file after a successful non-print transfer. Deletion applies to the file’s final path (after any rule move). Keep this false if you need to keep delivered files on disk.

Managing the Printer Daemon

Windows Service Management

Start/Stop from Services:

From PowerShell (Admin):

Start-Service LideritConnector Stop-Service LideritConnector Restart-Service LideritConnector Get-Service LideritConnector

Linux Service Management

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

View logs:

sudo journalctl -u liderit-connector -f

Uninstall

Windows:

%LOCALAPPDATA%\LideritConnector\connector.exe -uninstall

Linux:

sudo ./uninstall-linux.sh