Beginner quick start

Understand the three downloads, collect the required values once, then follow one path without guessing.

Odoo 19.0 & 18.0 supported

Read this before editing .env: XiotBox currently uses Docker for Runtime. If Docker, DNS or a public TLS certificate are unfamiliar, start with a trusted-LAN acceptance test or ask an administrator to prepare the Runtime host. Do not expose the LAN profile to the Internet.

Before anything else: XiotBox runs on top of Odoo 18/19 and the separately licensed VentorTech printnode_base module. You must already operate Odoo and have a legally obtained printnode_base build installed and licensed — XiotBox does not include either. There is nothing to deploy until that module is present; if you are not sure, start at Requirements.

What you are installing

1. Odoo module

Installed inside Odoo. It provides printer management, Runtime Manager and SocketD Manager.

2. Runtime package

Installed once on a Docker-capable computer or server. It contains Runtime with an embedded SocketD — do not install a separate SocketD service.

3. Desktop client

Installed on each computer that owns a printer. Do this only after Runtime is healthy.

The beginner path

Create or sign in to your XiotBox portal account.
Add the free module product to the cart, place the order and download the matching Odoo module.
Install Odoo Direct Print PRO (printnode_base) first, then install the XiotBox module and open Self-hosted Print → Configuration → Settings.
Open Runtime Manager, create one record for the physical Runtime using its intended public URL, then copy the automatically generated Management Token.
Download XiotBoxRuntime-1.1.1-docker-amd64.tar.gz from Customer Downloads.
Copy the supplied environment template to .env, paste that Management Token, and fill only values from the table below. Never invent a token.
Start Runtime and confirm its health check.
Return to the same Runtime Manager record, click Refresh Status and Refresh License, then click Claim This Runtime.
Install the desktop client, complete one test print, then renew from My Runtimes when ready.

Where every important value comes from

.env value	Where to obtain it	Important rule
`OG_ODOO_DATABASE`	Your exact Odoo database name.	Do not use the company name unless it is also the database name.
`OG_RUNTIME_TOKEN`	Generate or copy it from Self-hosted Print settings in Odoo.	This authorizes Runtime to call Odoo.
`SOCKETD_TOKEN`	Generate or copy it from the same Odoo settings page.	It is not the Runtime Management Token.
`XIOTBOX_MANAGEMENT_TOKEN`	Runtime Manager generates it automatically. An administrator can use Reveal / Copy Management Token.	Paste the identical value into the Runtime deployment. Wrong values cause HTTP 401.
`XIOTBOX_LICENSE_KEY`	Leave it empty for a new automatic 30-day trial.	Only enter a key supplied for an existing paid or offline License.
`XIOTBOX_LICENSE_PUBLIC_KEY`	Use the License verification public key supplied with the Runtime delivery instructions.	This is a public verification key, not a private signing key. If it was not supplied, stop and contact support.
`OG_RUNTIME_PUBLIC_URL`	The address Odoo uses to reach Runtime, for example `https://print.example.com/runtime`.	Use HTTPS for Internet-facing installations.
`SOCKETD_PUBLIC_URL`	The native socket address desktop clients reach, normally `tls://print.example.com:9019`.	Do not replace `tls://` with `https://`.

Management Token: what it is used for

It is not a one-time activation code. It remains the Bearer credential used by Runtime Manager for status, version, device and License checks. It is masked in the edit field, but Runtime Manager administrators can reveal and copy it when pairing, migrating or recovering a Runtime.

Do not create a second Runtime Manager record to simulate a new Runtime. One physical Runtime has one persistent installation identity. A second record pointing to the same URL still manages the same trial or subscription.

Stop and ask for help if

You have not yet installed and licensed printnode_base (VentorTech Direct Print PRO).
You do not know the database name.
The License verification public key was not supplied.
Docker cannot start the Runtime container.
The Runtime URL is not reachable from Odoo.
Runtime Manager reports HTTP 401.
You are about to expose the LAN profile to the Internet.

You know what each value means.Next: install the Odoo module →