Odoo IoT-Box: Geräte, Netzwerk, Einrichtung

Was Sie vorab brauchen

Die IoT-Box ist ein kleiner Rechner mit vorinstalliertem Odoo-IoT-Programm. Sie hängt im lokalen Netzwerk und macht die angeschlossenen Geräte für Ihre Odoo-Datenbank nutzbar: Drucker, Waagen, Messgeräte, Kameras, Fußschalter, Bildschirme und Barcode-Scanner. Statt der Box läuft das virtuelle Windows-IoT als Programm auf einem Windows-10- oder Windows-11-Rechner; Kameras und Messgeräte unterstützt nach der Dokumentation nur die IoT-Box.

Odoo führt die IoT-App in seiner Editionsübersicht als Enterprise-Funktion. Enterprise läuft nach der Preisseite von Odoo S.A. wahlweise als Odoo Online, auf Odoo.sh oder selbst gehostet; laut dieser Seite ist das dieselbe Software, es unterscheiden sich nur Hosting und Infrastruktur. Unabhängig von der Hostingart muss das IoT-System die Produktionsdatenbank erreichen und darf der Server keine Umgebung mit mehreren Datenbanken verwenden.

Halten Sie bereit:

• die IoT-App in Ihrer Datenbank; die Installation braucht Administratorrechte
• eine IoT-Box oder einen Windows-Rechner für das virtuelle Windows-IoT
• ein Netzwerkkabel oder die WLAN-Zugangsdaten
• die Geräte samt Kabeln, bei Waagen und Messgeräten zusätzlich die Bedienungsanleitung

Für den Produktivbetrieb verlangt Odoo ein IoT-Box-Abonnement, auch als Voraussetzung für das HTTPS-Zertifikat. Nach der IoT-FAQ von Odoo S.A., gelesen am 14. Oktober 2026, kostet es 25,00 Euro pro Monat und Box und wird automatisch dem Enterprise-Vertrag hinzugefügt; die Seite nennt einen Kaufpreis von 155,00 Euro und regionale Abweichungen. Preise ändern sich.

Netzwerk-Checkliste vor dem Koppeln

Mehrere Fehlerbilder der Fehlerbehebung liegen am Netzwerk. Prüfen Sie vor dem Koppeln:

• Der Browser, mit dem Sie koppeln, läuft im selben Netzwerk wie das IoT-System; die Verbindungsanleitung nennt das als Voraussetzung.
• IoT-Box und Geräte hängen im selben Netzwerk; das empfiehlt die Boxseite, und ein Netzwerkdrucker muss von der Box aus erreichbar sein.
• Die Box ist aus dem Internet nicht erreichbar; die Dokumentation nennt das ein Sicherheitsrisiko.
• Die Datenbank ist eine Produktionsinstanz und das Abonnement läuft (Status In Bearbeitung); beides verlangt die Dokumentation, damit die Box ein HTTPS-Zertifikat erhält. Ein gültiges HTTPS-Zertifikat brauchen laut Dokumentation einige Netzwerkgeräte wie Zahlungsterminals, um mit dem IoT-System zu kommunizieren.
• Router und Firewall lassen die Vergabe des Zertifikats zu und lösen die Adresse .odoo-iot.com auf; die Dokumentation rät, eine Firewall dafür vorübergehend zu deaktivieren und sonst das DNS im Router oder am Gerät umzustellen.
• Beim virtuellen Windows-IoT sind eingehende TCP-Regeln für 8069, 80 und 443 angelegt, für Worldline- und Axepta-Terminals zusätzlich 9050.
• Die LEDs neben dem Kartenschacht zeigen den Zustand: rot leuchtet ohne Internet, grün blinkt beim Warten auf eine Datenbank, grün leuchtet dauerhaft, wenn die Box verbunden ist.

Diese Geräte lassen sich anschließen

Die Box erkennt unterstützte Geräte an USB, Bluetooth, Netzwerk und HDMI selbst. Die Tabelle nennt je Geräteklasse Anschluss und Bedingung.

Gerät	Anschluss	Was die Dokumentation verlangt
Belegdrucker	USB, Netzwerk oder ePOS	Netzwerkbasierte ePOS-Drucker wie der Epson TM-m30 iii (Modelle 112 und 152) und iMin-Kassensysteme drucken aus dem Kassensystem auch ohne IoT-System; USB-ePOS- und ESC/POS-Drucker brauchen eines, Bluetooth-Drucker sind nicht kompatibel. Am IoT-System verlangt die Dokumentation Netzwerkdrucker im selben Netzwerk, Erkennung bis zwei Minuten; Epson-Bondrucker und Zebra-Etikettendrucker brauchen keinen Treiber
Etikettendrucker	USB oder Netzwerk	Etiketten über das ZPL-Format; DYMO-Serie-5-Geräte laufen nur mit dem virtuellen Windows-IoT
Waage	USB, bei seriellen Modellen mit Adapter	Im Kassensystem auch direkt per USB anschließbar; an der IoT-Box Einrichtung in den Kassensystem-Einstellungen; Ariva-S-Waagen brauchen das Mettler-Kabel 72256236 und eine geänderte Einstellung
Messgerät	USB oder Bluetooth	Nicht mit dem virtuellen Windows-IoT; am Kontrollpunkt (Typ Messung) oder am Arbeitsplatz (Aktion Messung vornehmen)
Kamera	USB	Nicht mit dem virtuellen Windows-IoT; Kontrollpunkt oder Arbeitsplatz mit der Aktion Bild aufnehmen
Fußschalter	USB	Arbeitsplatz, Reiter IoT-Auslöser, mit Aktion und optionaler Taste; die Dokumentation nennt a, b und c als standardmäßige Zuordnung der Pedale und rät, die tatsächliche Belegung durch Anschließen an einen Computer zu prüfen
Bildschirm	Micro-HDMI	Statusanzeige bei der Einrichtung, Kundenanzeige des Kassensystems oder Anzeige-URL einer Website
Barcode-Scanner	USB	Der Barcode muss mit dem ENTER-Zeichen (Tastencode 28) enden; meldet er sich als Tastatur, setzen Sie am Gerät Ist Scanner
Kassenschublade	RJ25 am Drucker	Wird am Belegdrucker angeschlossen, nicht an der Box
Zahlungsterminal	herstellerabhängig	Gehört zu den Netzwerkgeräten, die laut Dokumentation ein gültiges HTTPS-Zertifikat brauchen, um mit dem IoT-System zu kommunizieren; der Anschluss folgt der Dokumentation des Terminals

Schritt für Schritt: IoT-Box einrichten

Schritt 1: Aufstellort wählen und die Box ins Netzwerk bringen

Stellen Sie die Box zu den Geräten und planen Sie Strom- und Netzwerkanschluss ein; so bleiben die Kabelwege kurz und die Box im internen Netz. Kameras und Messgeräte brauchen die IoT-Box, weil das virtuelle Windows-IoT sie nach der Dokumentation nicht unterstützt.

Per Kabel: Ethernet-Kabel in die Box und in einen freien Routeranschluss, dann Strom anschließen. Per WLAN: Ethernet-Kabel weglassen, Box einschalten, einige Minuten warten und in den WLAN-Einstellungen des Rechners das Netz IoTBox-xxxxxxxxxxxx wählen. Der Browser öffnet die Startseite, sonst rufen Sie http://10.11.12.1 auf; klicken Sie dort im Abschnitt Internetstatus auf Konfigurieren und tragen Sie Netzwerk und Passwort ein.

Schritt 2: Geräte anschließen und einschalten

Verbinden Sie die Geräte nach der Tabelle oben und schalten Sie sie ein; unterstützte Geräte erkennt die Box selbst, Drucker können bis zu zwei Minuten brauchen. Für eine Waage als integriertes Gerät nennt die Dokumentation in EU-Mitgliedstaaten eine Zertifizierung als gesetzlich vorgeschrieben; die deutsche Rechtslage steht unten im Abschnitt zur Waage.

Schritt 3: IoT-System mit Odoo koppeln

Installieren Sie die IoT-App, öffnen Sie sie und klicken Sie auf Verbinden. Der Browser durchsucht das Netzwerk und verbindet ein gefundenes System automatisch; bei mehreren wählen Sie das passende aus. Wird keines gefunden, klicken Sie auf Kopplungscode verwenden und tragen den Code ein, den die Box auf einem externen Bildschirm zeigt oder über einen Bondrucker ausdruckt; er gilt bis zu zwei Stunden nach dem Einschalten. Stattdessen erzeugen Sie im Entwicklermodus über Offline-Kopplung ein Token und tragen es auf der Startseite im Feld Servertoken ein.

Schritt 4: Geräte in Odoo prüfen und verknüpfen

Nach dem Koppeln steht das IoT-System als Karte in der IoT-App, die Geräte unter IoT ‣ Geräte. Wählen Sie ein Gerät und klicken Sie auf Testen: Beim Drucker druckt der Test eine Testseite. Ist die Kassensystem-App installiert, fragt Odoo beim Koppeln im Fenster Mit einem Kassensystem verbinden nach dem zugeordneten Kassenstand; alternativ aktivieren Sie in den Kassensystem-Einstellungen unter Verbundene Geräte die Option IoT Box und wählen die Geräte aus. Für Messwerte und Bilder verknüpfen Sie das Gerät mit einem Prozessschritt: in der Qualitätsapp unter Qualitätskontrolle ‣ Kontrollpunkte mit dem Typ Messung oder Bild aufnehmen, in der Fertigungsapp am Arbeitsplatz unter Konfiguration ‣ Arbeitsplätze im Reiter IoT-Auslöser mit Aktion und optionaler Taste; die Reihenfolge der Auslöser zählt. Wie das im Ablauf zusammenspielt, beschreibt IoT in der Fertigung.

Schritt 5: Zertifikat und Updates abwarten

Mit einer Produktionsdatenbank und laufendem Abonnement fordert die Box selbst ein HTTPS-Zertifikat an; ihre Startseite wechselt dann auf eine Adresse mit der Endung .odoo-iot.com. IoT-Systeme aktualisieren sich wöchentlich selbst, ein Update lösen Sie auf der Startseite im Abschnitt Version aus; trennen Sie die Box währenddessen nicht vom Strom.

Waage an der Kasse: was in Deutschland gilt

Die Odoo-Dokumentation weist für EU-Mitgliedstaaten auf eine gesetzlich vorgeschriebene Zertifizierung hin, wenn eine Waage als integriertes Gerät verwendet wird. In Deutschland regelt das das Mess- und Eichgesetz (MessEG): Verwendet werden dürfen nur Messgeräte, die dem Gesetz und den darauf beruhenden Rechtsverordnungen entsprechen (§ 31 Abs. 1), und die wesentlichen Anforderungen gelten auch beim Zusammenschalten mit anderen Geräten, hier beim Anschluss an die Kasse (§ 31 Abs. 2 Nr. 1). Ein nach Abschnitt 2 des Gesetzes in Verkehr gebrachtes Messgerät gilt für die Dauer der Eichfrist als geeicht und darf danach nicht ungeeicht weiterverwendet werden (§ 37 Abs. 1); die Eichfristen bestimmt eine Rechtsverordnung nach § 41 Abs. 1 Nr. 6. Auf EU-Ebene gilt die Richtlinie 2014/32/EU nach ihrem Art. 2 Abs. 1 nur für die dort aufgeführten Messgeräte, für Waagen also nur für selbsttätige Waagen (MI-006); soweit sie gilt, treffen die Mitgliedstaaten nach Art. 7 Abs. 2 Maßnahmen, dass Messgeräte nur bereitgestellt und in Betrieb genommen werden, wenn sie die Anforderungen dieser Richtlinie erfüllen, wofür der Hersteller das Konformitätsbewertungsverfahren durchführt (Art. 8 Abs. 2). Ob ein Mitgliedstaat die Verwendung von Messgeräten für bestimmte Messaufgaben vorschreibt, steht nach Art. 3 Abs. 1 in seinem Ermessen.

Klären Sie vor dem Kauf, ob Ihr Waagenmodell für den geschäftlichen Einsatz zugelassen ist und wie lange die Eichfrist läuft; in Österreich und der Schweiz fragen Sie beim Hersteller oder bei der Eichbehörde. Die Einrichtung im Kassensystem beschreibt Waage an der Odoo-Kasse anschließen.

So prüfen Sie das Ergebnis

• Die Karte des IoT-Systems zeigt die Geräte; die Schaltfläche Testen prüft Verbindung und Internetqualität.
• Die grüne LED der Box leuchtet dauerhaft.
• Der Drucker hat eine Testseite gedruckt, und der Kassenstand zeigt unter Verbundene Geräte den richtigen Drucker.
• Ein Messgerät liefert am Kontrollpunkt oder Arbeitsplatz einen Wert ohne Eintippen; die Statusgrafik am Arbeitsauftrag zeigt die Verbindung.

Wenn etwas nicht klappt

Symptom	Ursache nach Dokumentation	Lösung
Kopplungscode erscheint nicht	Box ist nicht im Netzwerk, mit einer Datenbank verbunden oder der Code ist abgelaufen	Netzwerk prüfen, Box trennen und neu starten
IoT-System verbindet sich nicht mit der Datenbank	Das erste Verbinden dauert einige Minuten; sonst erreicht das IoT-System die Datenbank nicht, oder der Server verwendet eine Umgebung mit mehreren Datenbanken	Erreichbarkeit prüfen und die Box oder den Dienst des virtuellen Windows-IoT neu starten
Gerät fehlt in der Geräteliste	Gerät wurde nicht erkannt oder ist nicht unterstützt	Startseite der Box, Bereich Geräte, Anzeigen prüfen; Drucker am Druckerserver ergänzen
Drucker druckt Zeichensalat	Falscher oder fehlender Treiber	Am Druckerserver Marke und Modell neu setzen
Adresse auf .odoo-iot.com nicht erreichbar, IP-Adresse aber schon	DNS-Auflösung	DNS im Router oder am Gerät umstellen
Kein HTTPS-Zertifikat	Keine Produktionsinstanz, Abonnement läuft nicht, Firewall blockiert oder odoo.com ist nicht erreichbar	Instanz und Abonnement prüfen, Firewall kurz deaktivieren, Startseite neu laden; sonst Logs herunterladen und den HTTP-Statuscode an den Support melden
Virtuelles Windows-IoT von anderen Geräten nicht erreichbar	Windows-Firewall blockiert den Port	Regel für TCP 8069, 80 und 443 anlegen

Wann Sie Hilfe holen sollten

Router, DNS, Firewall und VLANs liegen außerhalb des Odoo-Supports; dafür ist Ihre Netzwerkbetreuung zuständig. Für Fernzugriff bietet die Startseite der IoT-Box unter Debugging-Tools die Eingabe eines Tailscale-Tokens, das der Odoo-Support stellt; laut Dokumentation gewährt schon dieses Token Zugriff auf die Box und auf Ihr gesamtes lokales Netzwerk. Die SSH-Verbindung richten Sie daneben unter Remote-Debug ein: Dort erzeugen Sie ein Passwort, das nach dem Schließen des Fensters nicht mehr abrufbar ist, und tragen das Authentifizierungstoken der Person ein, die sich verbinden will. SSH gibt es nur für die IoT-Box, nicht für das virtuelle Windows-IoT, und die SSH-Verwaltung gehört nicht zum Standard-Supportumfang von Odoo.