Installation

BlueNexus läuft auf einem Linux-Rechner in deinem Heimnetz. Ein Befehl richtet alles ein und startet die App als Dienst.

Voraussetzungen

• Ein Linux-Rechner mit apt: Raspberry Pi OS, Debian oder Ubuntu (Raspberry Pi 3, 4 oder 5 empfohlen, auch jeder andere Linux-Rechner oder -Container im Netz)
• Python 3.9 oder neuer (Debian 12 bringt 3.11 mit)
• Eine feste IP-Adresse für das Gerät, damit die Adresse stabil bleibt
• Nur für das Energie-Modul: eine Victron-Anlage mit GX-Gerät (im MultiPlus-II GX eingebaut oder als separater Cerbo GX). Am GX-Gerät muss unter Einstellungen → Dienste Modbus TCP eingeschaltet sein. Andere Hersteller werden nicht unterstützt. Ohne Victron wählst du das Energie-Modul ab und nutzt BlueNexus als reine Smart-Home-Zentrale.

Installation mit einem Befehl

Auf dem Gerät, per SSH oder im Terminal:

curl -fsSL https://raw.githubusercontent.com/Micha-3582/BlueNexus/main/app/deploy/install.sh | bash

Das Skript installiert die nötigen Pakete (Git, Python, bei Bedarf ffmpeg für Kameras), legt einen eigenen Dienst-Benutzer bluenexus ohne Anmeldung an, holt den Code nach /opt/bluenexus, richtet die Python-Umgebung ein und startet die App als Dienst. Der Dienst startet nach jedem Neustart von selbst. Das dauert einige Minuten.

Am Ende zeigt das Skript die Adresse an, meist http://<IP-des-Geräts>:5005.

Erste Schritte

1. Adresse im Browser öffnen und dein Konto anlegen. Das erste Konto wird zum Administrator. Dabei fragt die App nach deinem Vornamen und heißt dann z. B. „Michaels BlueNexus".
2. Module wählen: Energie (nur Victron), Smart Home, Verläufe, Kameras, Alexa. Du kannst das später jederzeit ändern. Im ersten Schritt des Assistenten führt „← Module ändern" zurück zur Auswahl.
3. Einrichtungsassistent (nur mit Energie): Adresse des GX-Geräts, Tibber-Zugang oder fester Strompreis, optional VRM. Ein Verbindungstest prüft Cerbo und Strompreisquelle.
4. Geräte suchen unter Smart Home → Geräte suchen: Systeme ankreuzen, suchen, Treffer benennen und hinzufügen.
5. Erst beobachten, dann scharf schalten: Die Ladesteuerung startet im Dry-Run und schreibt nichts auf das GX-Gerät. Neue Regeln lassen sich im Trockenlauf prüfen. Schalte erst scharf, wenn die Entscheidungen plausibel sind.

Aktualisieren

Am einfachsten in der App unter Einstellungen → System → App-Version & Update. Alternativ am Terminal:

sudo /opt/bluenexus/app/deploy/update.sh

Deine Daten (Konfiguration, Geräte, Regeln, Historie) bleiben dabei erhalten.

Sicherung und Umzug

Unter Einstellungen → System → Sicherung & Wiederherstellung speicherst du alle Einstellungen in einer verschlüsselten Datei. Bei einer neuen Installation spielst du sie auf der Startseite wieder ein („Schon eine Sicherung?"). Dafür brauchst du kein Terminal.

Von unterwegs erreichen

Ein Cloudflare-Tunnel lässt sich direkt in der App unter Einstellungen → System → Fernzugriff einrichten, ohne Portfreigabe im Router. Wer die App aus dem Internet erreichbar macht, sollte zusätzlich Cloudflare Access vorschalten.

Nützliche Befehle

sudo systemctl status bluenexus     # läuft der Dienst?
sudo systemctl restart bluenexus    # neu starten
sudo journalctl -u bluenexus -f     # Meldungen live ansehen

Weitere Optionen

Vor dem Befehl lassen sich Umgebungsvariablen setzen, z. B. PORT (Standard 5005), INSTALL_DIR (Standard /opt/bluenexus), NO_FFMPEG=1 (ffmpeg weglassen, nur für Kameras nötig) oder BLUENEXUS_REPO für einen Fork. Alle Optionen stehen im Kopf von install.sh.

curl -fsSL https://raw.githubusercontent.com/Micha-3582/BlueNexus/main/app/deploy/install.sh | NO_FFMPEG=1 PORT=8080 bash

Deinstallation

sudo /opt/bluenexus/app/deploy/uninstall.sh

Achtung: Das löscht auch alle Daten der App. Mach vorher eine Sicherung.

Probleme?

Das Handbuch auf GitHub erklärt alle Einstellungen. Fragen und Fehler bitte als Issue melden.