MuPiBox Dokumentation MuPiBox NG

Sicherheit & MuPiBox-App

Admin-Passwort setzen, die MuPiBox-App koppeln, Fernzugriff ohne VPN aktivieren und das Linux-Passwort für SSH ändern.

Unter Verbindungen & Schutz → Sicherheit schützt du die Verwaltung und änderst den Systemzugang. Die Kopplung der App findest du im eigenständigen Hauptmenü MuPiBox App, direkt unter Box & Bedienung.

Sicherheit

Screenshot einer Demo-Box; auf deiner Box ist das Admin-Passwort bereits gesetzt.

Admin-Passwort

Seit 0.2.0-alpha.44 ist das Admin-Passwort Pflicht: Ohne Passwort zeigt die Verwaltung nur die Einrichtung; es lässt sich ändern, aber nicht mehr entfernen.

Das Passwort schützt die gesamte Verwaltung – auch die Elternkontrolle. Wähle ein eigenes, langes Passwort. Es wird nur als gesalzener Hash gespeichert. Fehlversuche werden gebremst.

Vergessenes Admin-Passwort zurücksetzen

Einfachster Weg (ab 0.2.0-alpha.44): Per SSH als root die Datei /var/lib/mupibox-ng/reset-admin-password anlegen und den Dienst neu starten:

sudo touch /var/lib/mupibox-ng/reset-admin-password
sudo systemctl restart mupibox-ng

Beim Start entfernt MuPiBox den Passwort-Hash und alle Anmeldungen und löscht die Datei wieder. Danach zeigt die Verwaltung „Admin-Passwort festlegen“. Die folgende manuelle Anleitung funktioniert weiterhin.

Diese Schritte gelten für eine reguläre NG-Installation. Du benötigst SSH-Zugang oder eine lokale Konsole mit Administratorrechten. Das DietPi-/Linux-Passwort ist unabhängig vom Admin-Passwort der MuPiBox.

  1. Verbinde dich beispielsweise mit ssh dietpi@mupibox.local (alternativ die IP-Adresse der Box nutzen und mit deinem Linux-Benutzer anmelden).
  2. Führe diese Befehle auf der MuPiBox aus. Sie stoppen kurz den Backend-Dienst, erstellen eine geschützte Sicherung der Datenbank und löschen ausschließlich den gespeicherten Admin-Passwort-Hash:
# Auf der MuPiBox per SSH oder lokaler Konsole ausführen:
sudo systemctl stop mupibox-ng
sudo python3 - <<'PY'
from datetime import datetime
from pathlib import Path
import os
import sqlite3

db = Path("/var/lib/mupibox-ng/mupibox.db")
if not db.is_file():
    raise SystemExit(f"Database not found: {db}")
os.umask(0o077)
backup = db.with_name(f"mupibox-before-password-reset-{datetime.now():%Y%m%d-%H%M%S}.db")
with sqlite3.connect(str(db)) as connection:
    with sqlite3.connect(str(backup)) as destination:
        connection.backup(destination)
    connection.execute("DELETE FROM settings WHERE key = ?", ("admin.password_hash",))
print(f"Backup: {backup}")
PY
sudo systemctl start mupibox-ng
  1. Öffne danach das Admin-Interface (http://mupibox.local:8090 bzw. die IP deiner Box) und vergib unter Verbindungen & Schutz → Sicherheit → Admin-Passwort sofort ein neues Passwort.

Echte MuPiBox-App auf einem Smartphone

Beispiel der MuPiBox-Web-App mit Boxstatus, Player-Steuerung, Lautstärke und Nachrichtenfeld. Aufnahme aus der NG-Testversion; einzelne Menüs können sich ändern.

MuPiBox-App

Die installierbare MuPiBox-App steuert die Box vom Smartphone – Wiedergabe, Lautstärke, Nachrichten, Ein/Aus.

  1. Einmaliger Verbindungscode erzeugen.
  2. Auf dem Smartphone app.mupibox.de öffnen, Box-Adresse und Code eingeben.
  3. Die App erscheint unter Verbundene Apps und lässt sich dort wieder entfernen.

Im Heimnetz gehen alle Befehle direkt an die Box.

Ist die Elternkontrolle aktiviert und gespeichert, erscheint unter MuPiBox App zusätzlich Eltern-App. Damit erzeugst du einen eigenen Verbindungscode mit Elternrechten. Gewöhnliche App-Verbindungen bekommen diese Rechte nicht.

Fernzugriff ohne VPN

Mit „Fernzugriff ohne VPN aktivieren“ erreicht die App die Box auch unterwegs. Die Verbindung läuft dann über den MuPiBox-Relay, Ende-zu-Ende verschlüsselt: Der Relay sieht nur technisch nötige Verbindungsdaten (IP-Adressen, einen zufälligen Kanal, Zeitpunkte, Paketgrößen), nicht die Befehle selbst. Medien, Cover, Zugangsdaten oder die Box-Datenbank laufen nie über den Relay.

  • Fernzugriff erfordert ein gesetztes Admin-Passwort.
  • Nach dem Aktivieren alle Apps einmal neu koppeln, damit jede ihren eigenen Schlüssel erhält.

Systemzugang (SSH / Konsole)

Ändert das Linux-Passwort der Konten root, dietpi oder beider (8–100 Zeichen, keine Doppelpunkte oder Zeilenumbrüche). Das Passwort wird nicht in der MuPiBox gespeichert. Dafür muss zuerst ein Admin-Passwort gesetzt sein.

© 2026 MuPiBox