Install and configure the Odoo module

1. Put the modules on the addons path

1. Verify whether the server is Odoo 19 or Odoo 18.
2. Use the matching major-version branches of your licensed printnode_base and purchased xiotbox_lite, then place both directories in an addons directory. Never mix 18.0 and 19.0 modules.
3. Restart Odoo, enable developer mode and select Apps → Update Apps List.
4. Install Odoo Direct Print PRO, then install XiotBox Direct Print.

On Odoo.sh, commit both matching addon directories to the project repository and wait for a successful build instead of copying files through SSH.

2. Open XiotBox settings

Go to Self-hosted Print → Configuration → Settings. Confirm that a SocketD token was generated. Choose Separate Runtime / SocketD host for production and always for Odoo.sh.

3. Enter the addresses

• Runtime API URL: the HTTPS Runtime address, normally https://print.example.com/runtime.
• SocketD to Odoo URL: the browser-visible HTTPS URL of this Odoo database.
• SocketD Public URL: the native TLS address desktop clients can reach, normally tls://print.example.com:9019.

Click Validate Configuration. This validates syntax and encryption requirements; it does not prove that Runtime is already online.

4. Run Guided Setup

• Choose First-time installation if no Direct Print account exists.
• Choose Use or migrate an existing Direct Print account to preserve existing references.

If Runtime is not online yet, leave immediate device synchronization off. You can import devices after the desktop client connects.