MuPiBox Dokumentation MuPiBox Classic

Dateien, Ports und Dienste

Diese Seite ist für alle, die der Box „unter die Haube“ schauen wollen, zum Beispiel per SSH. Im Normalbetrieb brauchst du sie nicht

Diese Seite ist für alle, die der Box „unter die Haube“ schauen wollen, zum Beispiel per SSH. Im Normalbetrieb brauchst du sie nicht.

Wichtige Dateien und Ordner

PfadInhalt
/etc/mupibox/mupiboxconfig.jsondie Konfiguration der Box. Die App schreibt hier hinein, ebenso der Editor unter Experten
/home/dietpi/.mupibox/Sonos-Kids-Controller-master/die installierte Software: Server, App (mupi-app/), Display (www/) und dieses Handbuch (manual/)
/home/dietpi/.mupibox/spotifycontroller-main/der Player (Spotify und lokale Wiedergabe)
/home/dietpi/MuPiBox/media/die Medien auf der Speicherkarte (das ist auch die Samba-Freigabe mupibox)
/home/dietpi/MuPiBox/sysmedia/Systemdateien: Startbilder, Töne
/home/dietpi/mupibox-backups/die Sicherungen vor einem Update (before-update-….zip, die drei neuesten)
/usr/local/bin/mupibox/die Skripte der Box (Ausschalten, Drehregler, Netzwerk und mehr)
/tmp/playerstateder Zustand des Players: play oder pause
/tmp/shutdown_control.logLog des Ausschalt-Tasters
/tmp/idle_shutdown.logLog des automatischen Ausschaltens

Ports

PortWerWofür
80 und 443Webserverdie App (/app/), dieses Handbuch (/manual/) und die Admin-Oberfläche. Anfragen für App und Schnittstelle leitet er an den Server weiter
8200ServerDisplay und Schnittstelle der Box selbst. Das Display läuft über http://localhost:8200. Die App ist hier immer per http erreichbar (/app/)
5005Playerdie Schnittstelle des Players. Sie nimmt nur Befehle von der Box selbst an, nicht aus dem Netzwerk

Programme (PM2)

Zwei Programme laufen unter PM2:

  • server: Server mit App, Schnittstelle und Handbuch,
  • spotify-control: der Player.

Ihre Meldungen stehen unter Einstellungen › System › Protokolle in den Logs server-out.log, server-error.log, spotify-control-out.log und spotify-control-error.log.

Dienste (systemd)

Weitere Aufgaben erledigen Dienste, deren Namen mit mupi_ beginnen. Die wichtigsten:

DienstAufgabe
mupi_startstopstartet und beendet die Box-Abläufe beim Hoch- und Herunterfahren
mupi_idle_shutdownschaltet die Box nach langer Stille aus
mupi_check_internetprüft die Verbindung (Statusanzeige)
mupi_rotaryDrehregler
mupi_fanLüfter
mupi_hat, mupi_hat_controlMuPiHAT und Akku
mupi_powerledBetriebs-LED
mupi_telegramTelegram-Bot
mupi_mqttMQTT und Home Assistant
mupi_tlsZertifikat für HTTPS (bei jedem Start und täglich über mupi_tls.timer geprüft)
mupi_vnc, mupi_novncFernsteuerung des Displays
mupi_wifi, mupi_autoconnect-wifi, mupi_ethernetWLAN und LAN
mupi_autoconnect_btBluetooth automatisch verbinden
mupi_goodbyedas Abschiedsbild bis zum Stromaus
© 2026 MuPiBox