Skip to Content
XiotBox Documentation

Install the transparent manual ZIP patch

A customer-only fallback for administrators who prefer inspectable scripts to an unsigned graphical installer.

Odoo 19.0 & 18.0 supported
Use this only as the documented fallback. Download it from Customer Downloads after purchase, verify the ZIP SHA-256 shown there, and retain the official PrintNode 4.29.3 installer. Do not obtain these files from email attachments or third-party links.

What the ZIP changes

The scripts stop PrintNode, verify the exact supported client version, back up the original configuration, change the two Runtime address values in edition_data.json, copy the inspectable MIT-derived gateway.py, then restart the client. The ZIP contains no PrintNode executable, application bundle or proprietary gateway.pyc.

Windows package

XiotBoxDesktopPatch-1.2.0-windows-manual.zip

For PrintNode 4.29.3 on Windows x86-64.

macOS package

XiotBoxDesktopPatch-1.2.0-macos-manual.zip

For the validated Apple Silicon PrintNode 4.29.3 baseline.

Windows installation

  1. Download the Windows manual ZIP and copy its SHA-256 value from Customer Downloads.
  2. Run Get-FileHash .\XiotBoxDesktopPatch-1.2.0-windows-manual.zip -Algorithm SHA256 in PowerShell and compare all 64 characters. Stop if they differ.
  3. Right-click the verified ZIP, open Properties, and use Unblock only if Windows displays that option. Extract it afterwards.
  4. Quit PrintNode. Right-click install_patch.bat and select Run as administrator.
  5. Enter the Runtime API URL, for example https://print.example.com/runtime. Do not enter the Odoo Web URL.
  6. Wait for the three [OK] lines, reopen PrintNode, sign in, and complete one test print.

Use check_status.bat to inspect the current endpoint. Use restore_official.bat as administrator to restore the first pre-patch backup. Backups remain under C:\ProgramData\XiotBoxDesktopPatch\backups.

macOS installation

  1. Download the macOS manual ZIP and compare Customer Downloads with shasum -a 256 XiotBoxDesktopPatch-1.2.0-macos-manual.zip.
  2. Extract it, open Terminal and change into the extracted directory.
  3. Make only the supplied command files executable:
chmod +x install_patch.command restore_official.command check_status.command
./install_patch.command
  1. Enter the Runtime API URL and then the current Mac administrator password. Terminal intentionally shows no password characters.
  2. After the three [OK] lines, open PrintNode, sign in and complete one test print.

If macOS blocks the verified script, right-click install_patch.command in Finder and choose Open, or approve only this item in System Settings → Privacy & Security. Never disable Gatekeeper globally.

Use ./check_status.command to inspect the endpoint. Use ./restore_official.command to restore the first pre-patch files and verify the official app signature. Backups remain under /Library/Application Support/XiotBoxDesktopPatch/backups.

Acceptance and rollback

□ The ZIP hash exactly matches Customer Downloads.

□ The script detected PrintNode 4.29.3.

□ The displayed Runtime URL is correct.

□ One computer and its printers are online in Odoo.

□ One harmless page prints exactly once.

□ The restore script returns the endpoint to the official service when tested.

Stop on any mismatch. Do not edit the version check, disable antivirus/Gatekeeper, or copy files into a different PrintNode version. Contact support@xiotbox.com with the displayed error and redacted logs.
Manual patch accepted.Next: complete the first print →