Teil 1: ioBroker installieren & richtige Adapter einrichten

von

Ziel dieses Teils
In diesem Abschnitt richten wir eine vollständige ioBroker-Installation ein – inklusive der notwendigen Adapter, um später im Projekt den Hyper 2000 lokal anzubinden und in Loxone zu integrieren.

➡️ Du lernst:
✅ Vorbereitung des Systems
✅ Installation von ioBroker auf einem Raspberry Pi
✅ Einrichtung des Web-Interfaces
✅ Installation und Bedeutung der relevanten Adapter

📌 Voraussetzungen

Damit dieser Teil funktioniert, brauchst du:

  • Raspberry Pi 4 (empfohlen, 4 GB) oder vergleichbare Plattform
  • 32 GB Micro-SD-Karte
  • Netzwerkanbindung (LAN oder WLAN)
  • SSH-Zugang oder Monitor + Tastatur
  • Grundkenntnisse im Umgang mit Linux-Shell

Diese Voraussetzungen dienen nur der Orientierung – die einzelnen Schritte erklären sich im Text.

🪶 1️⃣ Betriebssystem vorbereiten

🧰 Raspberry Pi OS installieren

  1. Lade den Raspberry Pi Imager herunter:
    👉 https://www.raspberrypi.com/software/
  2. Wähle im Imager Raspberry Pi OS Lite (64-bit)
    → kein Desktop = weniger Ressourcen, stabiler Betrieb.
  3. Öffne die erweiterten Einstellungen im Imager:
    • Hostname: iobroker
    • SSH aktivieren
    • Benutzername & Passwort setzen
    • WLAN konfigurieren (falls nötig)

Warum?
Ein Lite-Image ist ressourcenschonend und ideal für einen dauerhaft laufenden Smart-Home-Server.

🔐 2️⃣ Erstes Login per SSH

Nach dem ersten Start deines Raspberry Pi führst du folgendes aus:

ssh benutzer@IP-Adresse

Die IP findest du meist im Router-Dashboard (z. B. Fritz!Box).
Verwende einen SSH-Client wie PuTTY oder das Terminal auf Linux/Mac.

🔄 3️⃣ System aktualisieren

Führe folgende Befehle aus:

sudo apt update && sudo apt upgrade -y
sudo reboot

Das bringt dein System auf den aktuellen Stand und beseitigt bekannte Fehler.

🧱 4️⃣ Node.js installieren (Voraussetzung)

ioBroker benötigt Node.js als Laufzeitumgebung. Empfohlen wird aktuell Node 20 LTS:

curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

Prüfe danach:

node -v
npm -v

⚙️ 5️⃣ ioBroker installieren

Starte die Installation mit folgendem Script:

curl -sLf https://iobroker.net/install.sh | bash -

Dieses Script:

  • richtet den System-User ein
  • installiert Abhängigkeiten
  • setzt ioBroker als Service
  • aktiviert Autostart

Die Installation dauert ca. 5–15 Minuten.

🌐 6️⃣ Web-Interface öffnen

Nach der Installation erreichst du den ioBroker-Admin über deinen Browser:

http://IP-Adresse:8081

Beispiel:

http://192.168.178.50:8081

Wenn nichts angezeigt wird, prüfe den Status mit:

sudo systemctl status iobroker

🛠️ 7️⃣ Sinnvolle Grundkonfigurationen

📌 Feste IP vergeben

Damit sich dein iOBroker nicht ändert (wichtig für später), vergebe eine feste IP im Router.

Beispiel Fritz!Box:

Heimnetz → Netzwerk → Gerät → „Diesem Gerät immer die gleiche IP zuweisen“

🔌 8️⃣ Adapter installieren

Im Admin-Interface wechselst du zu Adapter → Suchfeld und installierst nacheinander:

  • Zendure Solarflow – benötigt für die lokale Hyper-Integration
  • Simple API – zur bidirektionalen Datenkommunikation
  • MQTT – späterer Broker für lokale MQTT-Kommunikation

Adapter dürfen grundsätzlich über das Admin-Interface installiert werden – der dortige Standard („Default“) ist stabiler als direkte Installationen über Git oder npm.

🧠 Was wird als Nächstes passieren?

💡 In Teil 2 binden wir den Hyper 2000 lokal ein, konfigurieren die Adapter detailliert und testen den Datenfluss.

Schreibe einen Kommentar