Choose the right deployment topology

Decide where Odoo, Runtime and SocketD live before assigning hostnames.

Odoo 19 · XiotBox 19.0.2

The three connections

Odoo ──HTTPS──> Runtime API
Runtime/SocketD ──HTTPS──> Odoo /socketd/*
Desktop client ──TLS or WSS──> SocketD

These addresses are not interchangeable:

Setting	Who uses it	Example
Runtime API URL	Odoo and desktop HTTP API	`https://runtime.example.com`
SocketD to Odoo URL	SocketD callbacks	`https://odoo.example.com`
SocketD Public URL	Desktop persistent connection	`wss://socketd.example.com/ws`

Supported choices

Self-managed Odoo

Runtime may run beside Odoo or on a separate host. A separate host is recommended for production isolation and upgrades.

Odoo.sh

The Odoo module runs on Odoo.sh. Runtime + SocketD must run on a separate customer-managed host. Never select same-host mode.

Read the Odoo.sh guide

Port choice

Prefer HTTPS/WSS on port 443 because corporate networks frequently block custom ports. A native TLS port such as 9000 is supported only when every client network and firewall permits it.

Topology selected?Next: install the Odoo module →