Install and configure the Odoo module

1. Put the modules on the addons path

1. Verify the server is Odoo 19.
2. Place your licensed printnode_base and purchased xiotbox_lite directories in an addons directory.
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 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.
• SocketD to Odoo URL: the browser-visible HTTPS URL of this Odoo database.
• SocketD Public URL: the TLS/WSS address desktop clients can reach.

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.