UltraprintHub Documentation
Step 1: Installation Guide
Download the Hub from your Odoo Skillz account. Run the installer on Windows or extract the tarball on Linux. The Hub runs as a background service and starts automatically on boot.
Step 2: Configuration Reference
Edit config.json in the Hub directory to customize: Odoo URL, polling interval, log level, printer defaults, and failover settings. All changes take effect on restart.
Step 3: Printer Setup
Add printers via the web UI at http://localhost:8080 or through the system tray menu. Supported protocols: USB (libusb), Network (TCP/9100), Bluetooth (RFCOMM).
Step 4: Troubleshooting
Common issues: "Disconnected" — check Odoo URL and credentials. "Printer not found" — verify USB permissions (Linux) or driver installation (Windows). "Garbled output" — match paper width in settings.
Step 5: Developer API
The Hub exposes a local REST API on port 8080 for custom integrations. Endpoints: GET /status, POST /print, GET /printers, POST /printers/{id}/test. Authentication uses your Odoo API key.
Next step: Get support →
Frequently Asked Questions
What ports does the Hub use?
The Hub listens on port 8080 for the web UI and API. Outbound connections use HTTPS (443) to communicate with Odoo.
Where are logs stored?
Windows: %APPDATA%\UltraprintHub\logs. Linux: /var/log/ultraprint-hub/. Log rotation keeps 7 days of history.
How do I update the Hub?
The Hub auto-checks for updates daily. Manual updates: download the latest version and run the installer — it preserves your configuration.
Can I run the Hub in Docker?
Yes. Use the official image: docker pull odooskillz/ultraprint-hub. Mount your config.json and /dev/usb for printer access.
Is the Hub open source?
The Hub client is proprietary. The Odoo module and API specifications are open source and available on GitHub.
Ready to Print Smarter?
Join thousands of businesses printing receipts, labels, and kitchen tickets directly from Odoo — no IoT Box needed.
Get Ultraprint → Contact Sales