Raspberry Pi / Debian Troubleshooting

Raspberry Pi / Debian Troubleshooting

von

Zuletzt aktualisiert am 21. März 2026 von Lars

Raspberry Pi / Debian Troubleshooting. Auch wenn das Linux der Raspis sehr stabil ist, kann es doch zu dem ein oder anderen Problem kommen. Die gelernten Lösungsmethoden sammele ich hier.

Raspberry Pi Troubleshooting - Netzteil

Viele Probleme liegen an einer schlechten Spannungsversorgung. Nimm am besten die Original-Netzteile, teste verschiedene und auch verschiedene Kabel.

WLAN-Powermanagement deaktivieren

WLAN scheint öfter ein Problem zu sein bei den Raspis. Es kann helfen, das WLAN-Powermanagement zu deaktivieren.

WLAN-Powermanagement überprüfen

$ sudo iwconfig wlan0

Sollte iwconfig fehlen (zum Beispiel bei einem Radxa Rock) kannst du es so erst einmal installieren:

$ sudo apt update
$ sudo apt install wireless-tools

Falls im Ergebnis "Power Management:on" steht, ist das Powermanagement aktiviert, was eher deaktiviert werden sollte.

$ sudo nano /etc/systemd/system/wifipower.service

Folgendes in die Datei schreiben

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/iw dev wlan0 set power_save off

[Install]
WantedBy=multi-user.target
--

Das Script erstellt einen systemd-Service, der beim Start automatisch den WLAN-Energiesparmodus deaktiviert.

Falls das nicht funktioniert, dann eventuell, weil der Dienst zu früh gestartet wird.

Versuche

[Unit]
Description=Disable Wi‑Fi Power‑Save
# Warte, bis das Netzwerk vollständig hochgefahren ist
Wants=network-online.target
After=network-online.target

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/iw dev wlan0 set power_save off
# Optional: ein kurzer Sleep, falls das Interface noch nicht bereit ist
# ExecStartPre=/usr/bin/sleep 2

[Install]
WantedBy=multi‑user.target

Aktivieren mit

$ sudo systemctl enable wifipower.service 
$ sudo systemctl start wifipower.service

Rebooten und überprüfen

IP von dynamisch auf Fix stellen

systemd-networkd aktivieren

Wechselt von dhcpcd zu systemd-networkd für stabilere Netzwerkeinstellungen

$ sudo systemctl stop dhcpcd
$ sudo systemctl disable dhcpcd

$ sudo systemctl enable systemd-networkd
$ sudo systemctl start systemd-networkd

IP eintragen

IP und Gateway nach deiner Konfiguration anpassen:

$ sudo tee /etc/systemd/network/10-wlan0.network >/dev/null <<'EOF'
[Match]
Name=wlan0

[Network]
Address=192.168.0.50/24
Gateway=192.168.0.1
DNS=192.168.0.1
EOF

Neustart

$ sudo reboot

Kontrollieren

$ ip a show wlan0

Wenn dort die richtige IP steht, ist das erledigt.

Fixe IP beim Radxa Rock

Beim Radxa Rock kannst du das über "rsetup" > Connectivity machen.

Probleme mit der SD-Card

Ich hatte bei einem Raspberry Pi Zero ständig Stocker und Ausfälle.

Mittels ...

$ dmesg

... habe ich mir die Kernel-Meldungen ausgeben lassen. Dabei sind zunächst einige Zeilen Ausgabe erschienen. Danach ging lange nichts, bevor der Rest angezeigt wurde.

Anschliessend immer wieder sehr lange Pausen bei den Meldungen . Hier hilft übrigens eine KI bei der Auswertung relativ gut.

Eine 1:1 Kopie der SD-Card erstellen

Ich habe die SD‑Card zur Sicherheit auf eine neue auf meinem Mac kopiert.

$ diskutil list

Die Bezeichnung der SD-Card, bei mir /dev/disk4, habe ich mir gemerkt.

SD-Card unmounted

$ diskutil unmountDisk /dev/disk4

SD-Card gesichert in Image-Datei

$ sudo dd if=/dev/disk4 of=~/raspi_backup.img bs=4m status=progress

Auch wenn du 2 SD-Card-Slots hast, lohnt sich meiner Meinung nach der Weg über das Backup-File. Zum einen verwechselst du die Bezeichner sicher nicht und hast zum anderen auch noch die Backup-Datei für weiteres Trouble-Shouting.

SD-Karte entfernen und neue einlegen. Wieder

$ diskutil list

Bezeichner merken (bei mir auch wieder disk4) und unmounten

$ diskutil unmountDisk /dev/disk4

Image-File zurückspielen

$ sudo dd if=~/raspi_backup.img of=/dev/rdisk4 bs=4m status=progress

rdiskn ist (raw device) und eventuell schneller.

SD Card in Raspi booten und die dmesg-Meldungen vergleichen.

Tests direkt auf der SD-Card

Für die Tests darf die SD-Card nicht gemountet sein. Wenn du viel mit Rasperry Pi machst, hast du hoffentlich noch einen Linux-Rechner mit einem SD-Card-Leser.

fsck repariert direkt erkannte Probleme.

$ sudo fsck -f /dev/mmcblk0p2

badblocks zeigt defekte Sektoren. Wenn ja, SD-Card ersetzen.

$ sudo badblocks -v /dev/mmcblk0p2

Rasberry Pi in Kommandozeile booten lassen

Booten in Kommandozeile:

sudo systemctl set-default multi-user.target

Booten in grafische Benutzeroberfläche:

sudo systemctl set-default graphical.target

Stabilität erhöhen, speziell Rasperry Pi Zero

over_voltage=1 erhöht die Core-Spannung minimal (+0.025 V).

Das kann bei instabilem WLAN, SD-Zugriffen oder Billig-Netzteilen helfen.

over_voltage=1

ganz unten in /boot/firmware/config.txt eintragen.

WLAN via Kommadozeile konfigurieren

Die Zugangsdaten sind beim Raspberry Pi in einer Datei

/etc/wpa_supplicant/wpa_supplicant.conf

Darin stehen die Daten in dieser Form

network={
   ssid="WLAN-SSID"
   psk="WLAN-Passwort"
}

Verbinden mit

nmcli dev wifi connect "WLAN-SSID"

Dein WLAN auf "systemweit" setzen:

$ sudo nmcli connection modify "WLAN-SSID" connection.permissions ""

Autostart aktivieren:

$ sudo nmcli connection modify "WLAN-SSID" connection.autoconnect yes

Cloudinit Meldungen beim Systemstart

Das kommt, wenn man die SD-Card via Raspberry Pi Imager vorkonfiguriert hat.

Entfernen kann man das durch Anlegen einer leeren Datei im richtigen Verzeichnis

$ sudo touch /etc/cloud/cloud-init.disabled

"Username" ist nicht in der sudoers Datei

Dies kam nicht auf einem Raspberry Pi vor, aber auf einem Notebook mit Debian.

Als "root" anmelden.

$ usermod -aG sudo username

Falls usermod nicht gefunden wird, versuche

$ /usr/sbin/usermod -aG sudo username

Neu starten.

.deb-Datei installieren (zum Beispiel 1 Password Installationsdatei)

$ sudo dpkg -i dateiname.deb

Bei Fehlern wegen Abhängigkeiten noch

$ sudo apt-get install -f

Lokales Display ansteuern

Ich habe ein gebrauchtes "3.5inch Resistive Touch Display, 480x320, SPI Interface" erstanden, wahrscheinlich von Wayland. Die Ansteuerung war ziemlich viel Try & Error und ich bin hier nicht sicher, ob ich alle Schritte richtig dokumentiert habe.

Das Display blieb zunächst beim Booten weiss. Ursache ist hier wohl, dass das Raspi-OS versucht hat, eine grafische Oberfläche zu starten, was aber nicht funktioniert. Per SSH war der (vorkonfigurierte) Zugriff allerdings möglich.

Folgendes hat das Display zum Leben erweckt:

$ git clone https://github.com/goodtft/LCD-show.git
$ sudo chmod -R 755 LCD-show
$ cd LCD-show/
$ sudo ./LCD35-show

Mit

$ con2fbmap 1 1

getestet, ob die Ausgabe klappt.

Wichtig ist festzustellen, wie das Display heisst. Mit

$ ls /dev/fb*

vorhandene Devices anzeigen. Das schränkt das Troubleshooting ein.

Ich habe jetzt ausserdem noch in der /boot/firmware/config.txt am Ende stehen.

[all]
hdmi_force_hotplug=1
dtparam=i2c_arm=on
dtparam=spi=on
enable_uart=1
dtoverlay=tft35a:rotate=90
hdmi_group=2
hdmi_mode=1
hdmi_mode=87
#hdmi_cvt 480 320 60 6 0 0 0
hdmi_drive=2

Es steht noch aus, alles zu untersuchen. Sehr wahrscheinlich ist nicht alles nötig.

Schriftgrösse lässt sich so festlegen:

$ sudo dpkg-reconfigure console-setup

Die Schriftart Terminus ist am besten für kleine Displays.

Mögliche Grössen:

  • 8x16
  • 10x20
  • 12x24
  • 14x28
  • 16x32

Anschliessend aktualisieren mit

$ sudo setupcon

Cronjob und Display

Ein Cronjob sollte auf dem Display ausgeben. Das war nicht ganz trivial. Schliesslich hat es so geklappt:

display.sh

#!/bin/bash
export TERM=linux
export HOME=/home/lars
export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
sleep 40
/usr/bin/bash -c "con2fbmap 1 1 && clear > /dev/tty1 && \ /home/lars/scripts/showweather.sh > /dev/tty1"

Die Export-Anweisungen waren relevant, weil sonst cron keine Kenntnis von den nötigen Variablen hat.

Root-Cronjob

*/10 * * * * /home/lars/scripts/display.sh

Falsche Uhrzeit wegen falscher Zeitzone

Das Problem hatte ich auf einem Radxa Rock.

Aktuelle Uhrzeit feststellen

$ date
Sun Jan 18 07:37:23 PM UTC 2026

UTC ist falsch. Korrigieren mit

$ sudo timedatectl set-timezone Europe/Berlin

Anschliessend mit dem "date" Befehl noch einmal testen.

sudo apt install verlangt DVD

$ sudo vim /etc/apt/sources.list

Suche nach einer Zeile, die ganz am Anfang mit deb cdrom:[...] beginnt.

Setze ein Doppelkreuz # ganz an den Anfang dieser Zeile, damit diese Zeile auskommentiert wird.

Zugriff von extern

XRDP ist hier in der Regel einfacher als VNC zu konfigurieren. Bis jetzt habe ich es aber nur mit XCFE4 hinbekommen. Deshalb installiere ich Debian auch gleich immer damit.

System aktualisieren

$ sudo apt update
$ sudo apt upgrade

Desktop installieren (falls noch keiner da ist)

$ sudo apt install xfce4 xfce4-goodies

xRDP installieren

$ sudo apt install xrdp

xRDP aktivieren

$ sudo systemctl enable xrdp
$ sudo systemctl start xrdp

xRDP Benutzer zur SSL-Gruppe hinzufügen

$ sudo adduser xrdp ssl-cert

Neustart

$ sudo reboot

Desktop für xRDP festlegen

$ echo "startxfce4" > ~/.xsession

Firewall prüfen

Falls ufw aktiv:

$ sudo ufw allow 3389/tcp

Verbindung

  • RDP-Client (Windows "Remotedesktop", macOS "Windows", Linux "Remmina")
  • Ziel: IP-des-Debian-Systems
  • Benutzer: normaler Linux-User (nicht root)

1Password unter Debian Trixie installieren

Kann man so mit der heruntergeladenen .deb-Datei installieren:

$ sudo dpkg -i 1password-latest.deb

Falls eine Fehlermeldung wegen fehlender Abhängigkeiten erscheint:

$ sudo apt --fix-broken install

ARM-CPU

Auf ARM-CPUs funktioniert das aber nicht. Dort:

Download 1Password ARM

$ curl -sSO https://downloads.1password.com/linux/tar/stable/aarch64/1password-latest.tar.gz

Extract

$ sudo tar -xf 1password-latest.tar.gz

Dateien an den richtigen Ort kopieren

$ sudo mkdir -p /opt/1Password && sudo mv 1password-*/* /opt/1Password

Installation ausführen

$ sudo /opt/1Password/after-install.sh

1Password starten

$ 1password

Siehe auch Quelle: https://support.1password.com/install-linux/#arm-or-other-distributions-targz

Pi-Apps installieren

Pi-Apps ist ein alternativer App-Store für den Raspberry Pi

Installation

$ wget -qO- https://raw.githubusercontent.com/Botspot/pi-apps/master/install | bash

Themes / Icons

Mit Themes lässt sich die Benutzeroberfläche mächtig aufhübschen.

Ich verwende für XFCE4 meist

Installation

Systemweit

/usr/share/themes/

bzw.

/usr/share/ions/

Nur für deinen Benutzer

~/.themes/

bzw.

~/.icons/

Manchmal kommen die Ordner öfters vor und so ist es nicht immer ganz einfach, den richtigen zu finden.

Im richtigen Unterordner muss sich die Datei "index.theme" befinden.

Nextcloud‑Desktop‑Client installieren

So installierst du den Nextcoud-Desktop-Client unter Debian

$ sudo apt update
$ sudo apt install nextcloud-desktop

Keine Bluetooth Tools zur Verfügung (bei mir Surface Go 2)

Das ist bei Debian normal.

Pakete installieren

$ sudo apt update
$ sudo apt install bluetooth bluez bluez-tools

Optional (GUI, falls Desktop vorhanden):

$ sudo apt install blueman

Dienst aktivieren

$ sudo systemctl enable bluetooth
$ sudo systemctl start bluetooth

Status prüfen:

$ systemctl status bluetooth

→ Muss active (running) sein.

Adapter prüfen

$ bluetoothctl list

Windows Start-Taste geht nicht

Das Tastenkürzel muss manuell erstellt werden

  • Einstellungen
  • Tastatur
  • Tastenkürzel für Anwendungen.
  • Klicke auf den Button Hinzufügen.
  • Gib in das Feld "Befehl" folgendes ein: xfce4-popup-whiskermenu
  • Bestätige mit OK.

Die Taste zuweisen:

  • Sofort nach dem Klick auf OK erscheint ein Fenster, das auf eine Eingabe wartet.
  • Drücke jetzt die Start-Taste (Windows-Taste) auf deiner Tastatur.
  • In der Liste sollte nun Super L verknüpft mit xfce4-popup-whiskermenu stehen.

Vernünftiger CalDAV-Kalender für Debian

GNOME Kalender (gnome-calendar) läuft auch gut unter XFCE.

$ sudo apt install gnome-calendar -y

Ich habe eine Software Real VNC Connect installiert unter Debian und möchte sie nun wieder löschen. Der Installer war von der Homepage. Wie kann ich das erreichen

Paketliste prüfen

$ dpkg -l | grep vnc

Dort sollte ein Paket mit Namen etwa realvnc-vnc-server oder vncserver auftauchen.

Paket deinstallieren
Entferne das Paket samt Konfigurationsdateien:

$ sudo apt-get purge realvnc-vnc-server

(Falls das Paket einen anderen Namen hat, ersetze ihn entsprechend.)

Abhängigkeiten aufräumen

$sudo apt-get autoremove

TigerVNC-Viewer installieren

$ sudo apt update
$ sudo apt install tigervnc-viewer

Sublime installieren

$ wget -qO - https://download.sublimetext.com/sublimehq-pub.gpg | sudo tee /etc/apt/keyrings/sublimehq-pub.asc > /dev/null

$ echo -e 'Types: deb\nURIs: https://download.sublimetext.com/\nSuites: apt/stable/\nSigned-By: /etc/apt/keyrings/sublimehq-pub.asc' | sudo tee /etc/apt/sources.list.d/sublime-text.sources

$ sudo apt update

$ sudo apt install sublime-text

.AppImage-Datei nutzen

Datei ausführbar machen

$ chmod +x Programmname.AppImage

Starten

$ ./Programmname.AppImage

Sinnvollerweise in einen geeigneten Ordner packen. Falls nur für einen User, z. B.:

~/Applications/

Jetzt gegebenfalls noch ein Starter-Objekt anlegen.

Autostart?

"Sitzung und Startverhalten"

Blaulichtfilter

$ sudo apt install redshift redshift-gtk

Ort wird oft nicht gefunden. Manuell entsprechend so anpassen:

$ mkdir -p ~/.config
$ vim ~/.config/redshift.conf
[redshift]
temp-day=6500
temp-night=3500
location-provider=manual

[manual]
lat=47.5
lon=7.6

Appstore installieren

Zum Beispiel

$ sudo apt update
$ sudo apt install gnome-software gnome-software-plugin-flatpak

Emojis

Hier habe ich die App "Zeichen" via "Software" installiert.

Fenstermanager

Aktuellen Fenstermanager anzeigen lassen

echo $XDG_CURRENT_DESKTOP

XFCE4 installieren und aktiveren

sudo apt update
sudo apt install xfce4 xfce4-goodies
sudo apt install lightdm

Via lightdm aktivieren

$ sudo vim /etc/lightdm/lightdm.conf
user-session=xfce

Graphischer Taskmanager?

$ sudo apt install xfce4-taskmanager
$ xfce4-taskmanager

Druckerinstallation

Mein alter HP OfficeJet wurde zwar erkannt, aber druckte nicht. Es gibt aber ein Treiberpaket, das Abhilfe schafft.

$ sudo apt update
$ sudo apt install hplip

Anschliessend kann man einen Netzwerkdrucker so einrichten.

$ sudo hp-setup -i 192.168.0.240

192.168.0.240 war hier die IP meines Druckers.

.bash_profile vs. .bashrc

Ich hatte immer wieder das Problem, dass die eine oder andere Datei nicht aufgerufen wird.

.bash_profile wird nur bei Login-Shells geladen (z.B. SSH-Login, TTY-Login).

.bashrc wird bei interaktiven Nicht-Login-Shells geladen (z.B. ein neues Terminalfenster in einer Desktop-Umgebung).

Das Problem

Wenn du ein Terminal in einer grafischen Umgebung öffnest (GNOME, KDE, etc.), startet Bash meist als Nicht-Login-Shell – also wird .bash_profile gar nicht geladen.

Die Lösung: Gegenseitig aufrufen

In .bash_profile die .bashrc aufrufen:

# Am Ende von ~/.bash_profile
if [ -f ~/.bashrc ]; then
    source ~/.bashrc
fi

Zeit gespart? Dann unterstütze doch it-zeugs.de

Wenn dieser Tipp dir geholfen hat, Zeit zu sparen, überlege bitte, eine kleine Spende zu hinterlassen. Dein Beitrag hilft mir, weiterhin wertvolle Inhalte zu erstellen. Du kannst unter diesem Linke spenden: Spende it-zeugs.de

Falld du nicht spenden willst oder kannst, dann wäre es toll, wenn du deinen nächsten Amazon Einkauf mit diesem Link beginnen würdest: Amazon Link. Für dich wird es nicht teurer, ich bekomme aber einen kleinen Beitrag.

Vielen herzlichen Dank ❤️

Das könnte dich auch interessieren

  • Word 2013 Troubleshooting Word 2013 kann leider ziemlich zicken. Es gibt diverse Ursache, wenn Word nicht so will, wie es soll. Fix it…
  • Anmeldefehler Microsoft Office - Troubleshooting Troublehooting-Guide KontofehlerSystem aktuell?Abgemeldet arbeitenNeu-AnmeldenNeu-Anmelden mit Anmeldeinformationen löschenWindows Schnellstart deaktivierenVirenscannerDen Microsoft Support and Recovery Assistant benutzen, um Aktivierungsprobleme zu fixenRegistry-AnpassungKein Erfolg?…
  • iPhone Hotspot Probleme: Troubleshooting-Guide Hotspot nicht sichtbarAktiviere den persönlichen Hotspot auf deinem iPhoneMaximale Kompatibilität aktivierenWi-Fi auf dem Mac ein- und ausschaltenVerbinde mit dem HotspotHotspot…
  • Einstieg in Debian Linux [Tutorial] Nachdem ich aufgrund einer Fortbildung einige Gehversuche unter Ubuntu machen musste, über die ich in dem Artikel Einstieg in Linux…

Schreibe einen Kommentar