Skip to Content
XiotBox Documentation

Connect the official desktop client

Patch reversibly, sign in, and verify that each user sees only authorized devices.

Odoo 19.0 & 18.0 supported

Before patching

  1. Confirm Runtime and SocketD health checks pass.
  2. Download the supported desktop patch from Customer Downloads and verify its checksum.
  3. Download and retain the supported official PrintNode client installer (4.29.3) from the official PrintNode download page.
  4. Quit the PrintNode client completely and back up its current configuration.

If your operating system blocks the patch

Verify before allowing it: download only from XiotBox Customer Downloads and compare the file's SHA-256 value with the value shown in the portal. Stop if the values differ. Do not disable Gatekeeper, SmartScreen, antivirus, AppArmor or SELinux globally.

Windows

  1. Open the downloaded installer.
  2. If Microsoft Defender SmartScreen appears, confirm the filename and verified checksum.
  3. Select More info, then Run anyway.
  4. Approve the normal administrator prompt for this installer only.

macOS

  1. Copy XiotBox Desktop Patch from the DMG to Applications.
  2. Try to open it once, then close the warning.
  3. Open System Settings → Privacy & Security.
  4. Find the blocked app message, choose Open Anyway, authenticate, then confirm Open.

Allow this app only. Do not turn off Gatekeeper system-wide.

Linux

  1. Verify the downloaded artifact and its SHA-256 value.
  2. Mark only that file executable: chmod +x .
  3. Run it as the documented desktop user; elevate only when the patch requests access to the PrintNode installation.
  4. Keep AppArmor or SELinux enabled and record any denial instead of disabling policy globally.

Unsigned or ad-hoc-signed builds must be labelled as evaluation previews. Production artifacts should use Authenticode on Windows and Developer ID signing plus notarization on macOS.

Need a transparent fallback? Entitled customers may use the inspectable Windows or macOS manual ZIP instead of the graphical installer. It still verifies PrintNode 4.29.3, backs up the official files and supports restore. Read the manual ZIP guide →

Apply and configure

  1. Run the verified patch with the permissions requested by your operating system.
  2. Enter the Runtime API URL, for example https://print.example.com/runtime. Do not enter the Odoo URL.
  3. Start the official PrintNode client.
  4. Sign in with the XiotBox/Odoo account assigned to this installation, or use its issued API key where the client requests an API key.
  5. Wait for the computer and local printers to be reported.

Verify in Odoo

Open Self-hosted Print → Computers. The computer should be online. Open its Printers list and check that names match the operating system. A normal user must see only devices owned by or shared with that user.

Client upgrades can restore vendor defaults. After upgrading the official client, verify its Runtime address before sending production documents.

Undo the patch

Use the patch's Restore action or restore the backed-up configuration, then reinstall the retained official client if necessary. Confirm the endpoint has returned to the official service before cancelling XiotBox access.

A computer is online.Next: complete the first print →