Der offene
Multiprotokoll-Server
für Gebäudeautomation.
Verbinde KNX, Modbus TCP/RTU, 1-Wire, MQTT, Home Assistant, ioBroker und mehr — über einen einzigen, API-first, quelloffenen Hub. Ohne Vendor-Lock-in. Für immer.
Was ist der openbridge server?
Der openbridge server (obs) ist ein moderner, quelloffener Ersatz für proprietäre Gebäudeautomations-Server. Er verbindet industrielle und Heimprotokolle über einen einheitlichen, erweiterbaren Kern — API-first entwickelt, sodass jede Funktion der Web-GUI auch per REST oder WebSocket verfügbar ist.
Ursprünglich als offene Alternative zum Timberwolf Server (TWS) entwickelt, basiert obs auf Python 3.11+, läuft auf Linux (x86_64 und ARM Cortex-A72) und ist MIT-lizenziert — ohne jede Einschränkung.
API-First Architektur
Vollständige REST API + WebSocket. Die Web-GUI ist nur einer von vielen Clients — deine Automatisierungsskripte haben denselben erstklassigen Zugriff.
Open Source · MIT
Jede Zeile ist MIT-lizenziert. Fork, erweitern, in eigene Produkte einbetten. Keine Aktivierungsschlüssel, keine Abonnements.
8+ Protokoll-Adapter
KNX, Modbus TCP/RTU, 1-Wire, MQTT, Home Assistant, ioBroker, Zeitschaltuhr — jeder vollständig unabhängig, mehrere Instanzen pro Protokoll möglich.
Flexible History-Backends
SQLite funktioniert ohne Konfiguration. InfluxDB (v1/v2/v3) oder TimescaleDB werden zur Laufzeit über die UI eingebunden.
Architecture
KNX/IP ──┐
Modbus ──┤ ┌─ REST API ──▶ Web UI
1-Wire ──┼──▶ Protocol ──▶ Core ──▶ WebSocket ──▶ Clients
MQTT ──┤ Adapters Engine ──▶ MQTT topics
HA ──┤ └─ History ──▶ SQLite / InfluxDB
ioBroker──┘ └──▶ TimescaleDBUnterstützte Protokolle
Jedes Protokoll läuft als vollständig unabhängiger Adapter. Mehrere Instanzen desselben Protokolls gleichzeitig — jede mit eigener Konfiguration.
KNX / IP
Tunneling & Routing. 85+ DPT-Typen über erweiterbare Registry.
xknx · DPT 1–251 · Multi-Instanz
Modbus TCP
Mehrere simultane Verbindungen mit konfigurierbarer Byte-/Wortreihenfolge.
pymodbus · Coils, Register · Multi-Instanz
Modbus RTU Geplant
Serielle RS-485 Kommunikation für ältere Feldgeräte.
pymodbus · seriell · RS-485
1-Wire Geplant
Linux /sys/bus/w1/ Sensorintegration. DS18B20 und weitere.
w1thermsensor · DS18B20 · Temperatur
MQTT
Verbindung zu externen MQTT-Brokern. Bidirektional.
aiomqtt · TLS · Authentifizierung
Home Assistant
Echtzeit-Statussynchronisierung und Steuerung per WebSocket API.
WebSocket API · bidirektional
ioBroker
Bidirektionale Zustandsverwaltung. Import/Export von Objekten.
Socket.IO · Import/Export
Zeitschaltuhr
Zeitbasierte Trigger mit Cron, Feiertagen und Urlaubszeiten.
croniter · astral · Feiertage
∞ Mehrere simultane Instanzen — jedes Protokoll kann mehrere unabhängige Konfigurationen parallel betreiben.
Warum openbridge server?
Von Grund auf für moderne Gebäudeautomation entwickelt — offen, schnell und erweiterbar.
85+ KNX DPT-Typen
Die umfangreichste Open-Source KNX-Datenpunktypen-Registry. Erweiterbar per Registry-Pattern — neue DPTs ohne Eingriff in den Kerncode.
Visueller Logik-Editor
35+ Block-Typen für visuelle Automatisierung: Logikgatter, Mathematik, Timer, Python-Skripte, HTTP-Aufrufe, Astro-Trigger, Push-Benachrichtigungen.
Nullabhängige Historie
SQLite ist eingebaut und braucht keine Konfiguration. InfluxDB (v1/v2/v3) und TimescaleDB sind optionale Upgrades, die vollständig zur Laufzeit konfiguriert werden.
Echte Multi-Instanz
2× KNX, 3× Modbus TCP und 2× MQTT gleichzeitig — jede vollständig unabhängig mit eigener Konfiguration und Verbindung.
Vollständiger Import / Export
Gesamtkonfigurationen als JSON exportieren und importieren. KNX .knxproj-Dateien importieren, um Gruppenadressen in Sekunden anzulegen.
Mehrere Deployment-Optionen
Fertiges Proxmox LXC-Template oder Docker Compose — produktionsreif in Minuten. Systemd-verwaltet auf LXC für maximale Zuverlässigkeit.
| Aspect | openbridge server | Timberwolf Server |
|---|---|---|
| License | MIT (open source) | Proprietary |
| Configuration | REST API + YAML | Proprietary binary |
| KNX DPT support | 85+ types, extensible | Limited, crashes on unknown |
| History backend | SQLite (built-in) | InfluxDB (required) |
| Extensibility | Registry pattern | Hardcoded |
| ioBroker | Native adapter | Not supported |
| Home Assistant | Native adapter | Not supported |
Installation
Proxmox LXC — in wenigen Minuten einsatzbereit.
Das LXC-Template enthält ein vollständiges Ubuntu 26.04-System mit openbridge server und startet den Dienst automatisch beim Hochfahren des Containers.
Template herunterladen
- Auf der Release-Seite die URL der .tar.zst-Datei sowie den SHA512-Hash aus dem Abschnitt LXC Template kopieren.
- In der Proxmox-Weboberfläche zu Datacenter → Storage → local → CT Templates navigieren.
- Download from URL klicken.
- Die kopierte URL einfügen und auf Query URL klicken.
- Als Hash-Algorithmus SHA512 auswählen.
- Den kopierten Hash einfügen.
- Auf Download klicken.
Container erstellen
- Im Proxmox-Menü Create CT wählen.
- Als Template das gerade heruntergeladene ubuntu-plucky-openbridgeserver_… auswählen.
- Hostname, Passwort, CPU, RAM und Netzwerk nach Bedarf konfigurieren — empfohlen: mindestens 512 MB RAM.
- Container starten.
Zugriff
http://<container-ip>:8080 im Browser öffnen.
Standardzugang: admin / admin — Passwort sofort nach der ersten Anmeldung ändern (Einstellungen → Passwort).
Konfiguration anpassen (optional)
# Umgebungsvariablen in /etc/obs.env setzen, z. B.:
OBS_MQTT__HOST=192.168.1.10
OBS_SECURITY__JWT_SECRET=mein-geheimes-passwort
# Dienst neu starten
systemctl restart obsTip: Logs verfügbar via: journalctl -u obs -f
Docker Compose Generator
Erstelle eine vollständige docker-compose.yml für dein Setup — wähle die benötigten Services, fülle die Konfiguration aus und kopiere oder lade das Ergebnis herunter.
compose generator
Basis (immer enthalten)
Optionale Services
InfluxDB
Grafana
Reverse Proxy
Konfiguration
Generierte Dateien
InfluxDB 3 Core verwendet eine neue Storage-Engine. Das History-Backend in den OBS-Einstellungen nach dem Start konfigurieren.