Probleme bei der Installation

Wenn DietPi oder der MuPiBox-Installer nicht startet, WLAN fehlt, Download und Zertifikate scheitern oder kein Bild erscheint.

Diese Seite hilft während der ersten Installation. Ist NG bereits installiert und nur die Wiedergabe gestört, verwende stattdessen Fehlersuche.

Der Raspberry Pi startet nicht #

• Stimmt das Raspberry-Pi-DietPi-Image für 64 Bit? Ein 32-Bit-Image wird vom NG-Installer nicht unterstützt.
• SD-Karte korrekt geschrieben und sicher ausgeworfen? Bei Zweifeln neu flashen und die Installationsschritte vollständig wiederholen.
• Netzteil geeignet, Stromversorgung korrekt, Display-Kabel richtig eingesteckt?
• Ohne Display kann der Pi trotzdem starten. Im Router nach der IP-Adresse suchen.

WLAN-Verbindung während des Setups fehlt #

In der Boot-Partition nachsehen:

• Für WLAN wurde die WLAN-Vorlage als dietpi.txt gespeichert.
• In dietpi-wifi.txt stehen die korrekte SSID und der Netzwerkschlüssel.
• AUTO_SETUP_NET_WIFI_COUNTRY_CODE ist auf das tatsächliche Land gestellt.
• Kein doppeltes Dateisuffix wie dietpi.txt.txt.
• Testweise über LAN installieren (mit der passenden LAN-Vorlage); eine vergessene WLAN-Einstellung wird nicht durch einen späteren Browser-Aufruf repariert.

Die zwei DietPi-Netzwerkadapter beim ersten automatischen Start nicht beide gleichzeitig aktivieren.

Installation bleibt lange stehen #

Ein erster DietPi-Boot muss Downloads, Systempakete und gegebenenfalls Neustarts abarbeiten. Nicht nach wenigen Minuten hart ausschalten. Wenn keine Aktivität mehr erkennbar ist, Router/IP und Protokolle prüfen.

Wenn SSH erreichbar ist, kannst du dich mit dem in dietpi.txt gesetzten Systempasswort anmelden. Die folgenden Kommandos ändern nichts:

tail -n 80 /var/lib/mupibox-ng/install.log tail -n 80 /var/lib/dietpi/logs/dietpi-firstrun-setup.log systemctl --failed

Die erste Datei ist das MuPiBox-Installationsprotokoll und bleibt auch nach einem Neustart erhalten. Die zweite enthält die DietPi-Ersteinrichtung. Fehlt das MuPiBox-Protokoll, wurde eventuell das DietPi-Setup noch nicht abgeschlossen.

Zertifikatsfehler oder Download bricht ab #

Ein Pi hat oft keine eigene batteriegepufferte Echtzeituhr. Bei falschem Datum können HTTPS-Zertifikate ungültig erscheinen. Internetverbindung, DNS und Datum prüfen:

date -Is timedatectl status curl -I https://releases.mupibox.de/installer/install.sh

Der automatische MuPiBox-Installer versucht die Uhr vor dem sicheren Download zu korrigieren. Nicht die TLS-Zertifikatsprüfung deaktivieren, keine fremden Downloadserver oder unsignierten Releasepakete verwenden. Auch vorübergehende Störungen der Paketserver können Downloads verhindern.

Display dunkel, Admin aber erreichbar #

Die Installation kann funktioniert haben, obwohl die Grafikausgabe noch nicht stimmt. Prüfe unter Hardware → Display & Touch das Displayprofil; Display- und Kernelprofiländerungen benötigen meist einen Neustart. Weitere Diagnose: Display-Fehlersuche.

Admin-Oberfläche nicht erreichbar #

1. Die IP der Box im Router nachschlagen.
2. Von einem PC im gleichen LAN/WLAN http://<IP>:8090/admin/ öffnen.
3. Auch mit Port 8090 probieren, nicht nur die IP eingeben.
4. Bei Gäste-WLAN, VLANs oder Client-Isolation den gegenseitigen Zugriff prüfen.
5. Bei SSH-Zugang den Dienst lesen:

systemctl status mupibox-ng --no-pager journalctl -u mupibox-ng -b --no-pager -n 100

Release lässt sich nicht installieren #

• DietPi muss 64-Bit ARM sein und für WLAN-Verwaltung mindestens Version 10.7 besitzen.
• Ein nicht veröffentlichter Updatekanal oder fehlerhafte Signatur darf nicht stillschweigend übersprungen werden.
• Mangelnder Speicherplatz auf der SD-Karte kann Paketinstallation oder Entpacken verhindern:

df -h /

Hilfe anfordern #

Im GitHub-Issue-Tracker angeben: Pi-Modell, Display, WLAN/LAN, DietPi-Version, gewähltes Installationsprofil und die letzte eindeutige Fehlermeldung. Passwörter, WLAN-Schlüssel, Tokens und private IP-/Personendaten vor dem Teilen aus Logs und Screenshots entfernen.