Skip to Content
XiotBox Documentation

Before you begin

Collect every prerequisite before changing Odoo or a desktop computer.

Odoo 19 · XiotBox 19.0.2

What you need

□ Odoo 19 Community or Enterprise where custom modules can be installed.

□ A legally obtained Odoo 19 build of printnode_base. It is not included with XiotBox.

□ The purchased xiotbox_lite module and access to Customer Downloads.

□ One Linux host for Runtime + SocketD. For Odoo.sh this separate host is mandatory.

□ One test computer, one printer and the supported official PrintNode desktop client.

□ Administrator access to Odoo, DNS and the Runtime host.

Recommended production baseline

Runtime hostUbuntu 22.04/24.04 LTS, 2 vCPU, 4 GB RAM, 20 GB free disk
Domainsruntime.example.com and socketd.example.com
IngressTCP 443 from desktop networks; SSH restricted to administrators
EgressHTTPS from Odoo to Runtime and from Runtime to Odoo
TLSA valid public certificate whose hostname matches each public URL
Do not continue without a backup. Back up the database and filestore together. If migrating an existing account, also record its current endpoint and keep the official desktop installer.

Choose a maintenance window

A fresh installation can normally be prepared without interrupting users. For a migration, stop automated printing while endpoints and printers are being mapped. Keep the former PrintNode subscription active until the acceptance print succeeds.