MuPiBox Dokumentation MuPiBox NG

Installation

MuPiBox NG auf einem Raspberry Pi mit DietPi installieren – automatisch beim ersten Start oder per Befehl, mit passenden Profilen für Displays und WLAN.

MuPiBox NG wird auf DietPi (64 Bit) installiert. Es gibt zwei Wege: vollautomatisch beim allerersten Start der SD-Karte oder per Befehl auf einem bereits laufenden DietPi.

Was du brauchst

  • Raspberry Pi 3B+, 4 oder 5 (empfohlen: Pi 4 mit mindestens 1 GB RAM)
  • microSD-Karte ab 16 GB (oder USB-Stick/SSD, siehe Neustart & Power)
  • ein Display (offizielles Raspberry-Pi-Touchdisplay, Waveshare-DSI oder HDMI) – optional
  • Netzteil mit ausreichender Leistung; mit MuPiHAT über dessen USB-C-Eingang
  • Internetzugang während der Installation

Weg 1: Vollautomatisch beim ersten Start (empfohlen)

  1. Das aktuelle DietPi-Image für Raspberry Pi (64 Bit) von dietpi.com auf die SD-Karte schreiben.
  2. Die passende Vorlage von https://releases.mupibox.de/installer/ herunterladen und auf der Boot-Partition der SD-Karte als dietpi.txt speichern (die vorhandene Datei ersetzen):
VorlageFür
dietpi-mupibox-lan.txtNetzwerkkabel, beliebiges Display
dietpi-mupibox-wifi.txtWLAN, beliebiges Display
dietpi-mupibox-waveshare-5-dsi-lan.txt / -wifi.txtWaveshare 5″ DSI (800×480)
dietpi-mupibox-waveshare-4.3-dsi-lan.txt / -wifi.txtWaveshare 4,3″ DSI (800×480)
  1. Bei den WLAN-Vorlagen zusätzlich in dietpi-wifi.txt mindestens aWIFI_SSID[0] und aWIFI_KEY[0] eintragen und in der dietpi.txt den zweistelligen Ländercode (z. B. DE) setzen.
  2. SD-Karte einlegen und den Pi einschalten. DietPi richtet sich ein und startet danach den MuPiBox-Installer. Auf dem Display erscheint ein Installationsbildschirm mit Fortschritt.
  3. Nach dem abschließenden Neustart erscheint die Kinderoberfläche.

Weg 2: Per Befehl auf einem laufenden DietPi

Auf einem frischen 64-Bit-DietPi per SSH anmelden und ausführen:

server_date="$(curl -fsSI --max-time 5 http://releases.mupibox.de/ | sed -n 's/^[Dd]ate:[[:space:]]*//p' | tr -d '\r' | head -n1)"
[ -z "$server_date" ] || sudo date -u -s "$server_date" >/dev/null
sudo timedatectl set-ntp true >/dev/null 2>&1 || true
curl -fsSL https://releases.mupibox.de/installer/install.sh | sudo bash -s -- auto generic

Die ersten drei Zeilen stellen die Uhr grob, damit der verschlüsselte Download auch auf einem Pi ohne Echtzeituhr klappt. Für ein Waveshare-Display ersetzt du generic durch waveshare-5-dsi oder waveshare-4.3-dsi.

auto wählt den reifsten veröffentlichten Kanal (Stable → Alpha → Test → Development). Tester können stattdessen alpha, test oder development angeben.

Was der Installer macht

  • Systempakete installieren (Audio, Qt-Oberfläche, Hilfsprogramme)
  • das Release von releases.mupibox.de laden und dessen Signatur prüfen
  • Benutzer mupibox, Dienste und Startbild einrichten
  • das Displayprofil setzen und bei Bedarf neu starten

Alle späteren Updates laufen über die Verwaltung, siehe Updates.

Nach der Installation

Weiter geht es mit den ersten Schritten.