journalctl: Fehler unter Linux in den Logs finden
Mit journalctl findest Du heraus, warum ein Dienst streikt oder der Pi neu startet: nach Dienst, Zeit und Priorität filtern, Journal dauerhaft speichern.
Von Nathan Base
Ein Dienst startet nicht, der Raspberry Pi hat sich über Nacht neu gestartet, oder ein Skript läuft im Cronjob still ins Leere. Die Antwort steht fast immer im Systemprotokoll, nur gehen die entscheidenden Zeilen zwischen Tausenden harmlosen Meldungen unter. Mit journalctl und einer Handvoll Filter holst Du genau die Zeilen heraus, die Du brauchst, und sorgst dafür, dass die Protokolle auch einen Neustart überleben.
Die Befehle gelten für alle Systeme mit systemd, also für Raspberry Pi OS auf Basis von Debian 13 „Trixie“, Debian 13 selbst sowie Ubuntu 24.04 und 26.04. Ich habe sie mit den Handbuchseiten journalctl(1) und journald.conf(5) abgeglichen, Stand November 2026 mit systemd 257 unter Debian und 259 unter Ubuntu 26.04.
Die Grundlage: Journal lesen und darin blättern
Ohne weitere Angaben zeigt journalctl das komplette Journal vom ältesten Eintrag an. Das ist selten hilfreich. Für den Anfang reichen die letzten Meldungen:
journalctl -e-e öffnet die Anzeige direkt am Ende. Du blätterst mit den Pfeiltasten oder Bild auf und Bild ab, suchst mit / gefolgt von einem Suchbegriff und Enter, und verlässt die Anzeige mit q. Eine Zeile sieht typischerweise so aus:
Nov 17 08:12:03 raspberrypi sshd-session[812]: Accepted publickey for pi from 192.168.1.20 port 51522 ssh2Von links nach rechts stehen dort Zeitpunkt, Rechnername, das Programm mit seiner Prozessnummer in eckigen Klammern und die eigentliche Meldung.
Siehst Du stattdessen den Hinweis Hint: You are currently not seeing messages from other users and the system., fehlt Deinem Benutzer die Leseberechtigung für die Systemprotokolle. Setz dann ein sudo vor den Befehl. Der Standardbenutzer von Raspberry Pi OS und der beim Installieren von Ubuntu Server angelegte Benutzer gehören bereits zur Gruppe adm und dürfen alles lesen.
Die wichtigsten Filter
Die Stärke von journalctl liegt darin, dass Du die Filter beliebig kombinieren kannst. Jeder zusätzliche Filter grenzt die Ausgabe weiter ein.
Nach Dienst filtern
Willst Du wissen, was ein bestimmter Dienst gemeldet hat, nennst Du ihn mit -u:
journalctl -u ssh -eStatt ssh setzt Du den Namen des Dienstes ein, der Dir Sorgen macht, zum Beispiel docker, cron, nginx oder Deinen eigenen. Wie die Dienste auf Deinem System heißen, zeigt systemctl list-units --type=service. Hast Du einen eigenen Dienst nach der Anleitung Eigenen systemd-Dienst anlegen: Skripte dauerhaft starten eingerichtet, landet jede Ausgabe Deines Skripts genau hier.
Live mitlesen
Beim Einrichten ist es praktisch, die Meldungen in Echtzeit zu sehen, während Du in einem zweiten Terminal einen Dienst neu startest:
journalctl -u ssh -f-f zeigt die letzten zehn Zeilen und danach jede neue Meldung, sobald sie entsteht. Mit Strg + C beendest Du die Anzeige.
Nur Fehler und Warnungen
Jede Meldung trägt eine Priorität von emerg (0, das System ist unbrauchbar) bis debug (7). Mit -p siehst Du nur die angegebene Stufe und alles, was noch wichtiger ist:
journalctl -p err -bDas zeigt alle Fehler seit dem letzten Systemstart, -b steht dabei für den aktuellen Boot. Ist Dir das zu wenig, nimm -p warning, dann kommen die Warnungen dazu. Oft reicht dieser eine Befehl schon, um die Ursache eines Problems zu sehen.
Nach Zeit eingrenzen
Weißt Du ungefähr, wann es passiert ist, grenzt Du den Zeitraum ein:
journalctl --since "2026-11-17 08:00" --until "2026-11-17 09:00"Ersetze Datum und Uhrzeit durch Deinen Zeitraum. Die Sekunden darfst Du weglassen. Auch Angaben wie --since today, --since yesterday oder --since "1 hour ago" versteht journalctl.
Nach einem Begriff suchen
Mit -g durchsuchst Du die Meldungstexte. Schreibst Du den Suchbegriff klein, ignoriert die Suche die Groß- und Kleinschreibung:
journalctl -b -g "failed"Der Suchbegriff ist ein regulärer Ausdruck, "failed|error" findet also beide Wörter.
Nur Kernelmeldungen
Probleme mit Hardware, USB-Geräten, der Stromversorgung oder dem Speicher meldet der Kernel. Diese Meldungen allein bekommst Du mit:
journalctl -kBeim Raspberry Pi stehen hier zum Beispiel Hinweise auf Unterspannung, deren Ursachen der Artikel Raspberry Pi 5: Unterspannung und das richtige Netzteil erklärt.
Warum hat sich der Rechner neu gestartet?
Für diese Frage brauchst Du die Meldungen aus der Zeit vor dem Neustart. Welche Startvorgänge das Journal kennt, zeigt:
journalctl --list-bootsDie Ausgabe listet jeden Boot mit einer Nummer: 0 ist der aktuelle, -1 der davor und so weiter. Daneben stehen der erste und der letzte Eintrag jedes Boots. Das Ende des vorherigen Laufs siehst Du so:
journalctl -b -1 -eEndet das Protokoll mit geordneten Meldungen zum Herunterfahren, wurde der Neustart ausgelöst, etwa durch ein automatisches Update oder einen Befehl. Bricht es dagegen mitten im normalen Betrieb ab, ging die Stromversorgung verloren oder das System ist hängen geblieben, bis ein Watchdog es neu gestartet hat. Ergänzend lohnt ein Blick auf journalctl -b -1 -p warning und journalctl -k -b -1.
Bedenke dabei: journald schreibt normale Meldungen nur alle fünf Minuten auf den Datenträger. Bei einem plötzlichen Stromausfall können die letzten Minuten deshalb fehlen. Nur kritische Meldungen landen sofort auf der Platte.
Meldet journalctl -b -1 einen Fehler oder listet --list-boots nur einen einzigen Eintrag, speichert Dein System das Journal nicht dauerhaft. Das ist der nächste Abschnitt.
Das Journal dauerhaft speichern
Das Journal kann im Arbeitsspeicher oder auf dem Datenträger liegen. Im Arbeitsspeicher ist es nach jedem Neustart leer. Wie Dein System das handhabt, hängt von der Distribution ab:
| System | Standard |
|---|---|
| Raspberry Pi OS Trixie | nur im Arbeitsspeicher, um die SD-Karte zu schonen |
| Debian 13 (Neuinstallation) | dauerhaft auf dem Datenträger |
| Ubuntu 26.04 | dauerhaft auf dem Datenträger |
| Ubuntu 24.04 | dauerhaft, sofern /var/log/journal existiert |
Auf dem Raspberry Pi ist das eine bewusste Entscheidung von Raspberry Pi: Weniger Schreibzugriffe verlängern die Lebensdauer der SD-Karte. Für die Fehlersuche heißt das aber, dass nach einem unerwarteten Neustart alle Spuren weg sind. Läuft Dein Pi von einer SSD, oder willst Du einem wiederkehrenden Problem auf den Grund gehen, schaltest Du das dauerhafte Speichern mit einer Obergrenze ein. Lege dazu den Ordner für Zusatzeinstellungen an:
sudo mkdir -p /etc/systemd/journald.conf.dDanach schreibst Du die Einstellung in eine eigene Datei:
printf '[Journal]\nStorage=persistent\nSystemMaxUse=200M\n' | sudo tee /etc/systemd/journald.conf.d/90-persistent.confStorage=persistent speichert das Journal unter /var/log/journal, und SystemMaxUse=200M sorgt dafür, dass es nie mehr als 200 MB belegt, ältere Einträge werden dann automatisch gelöscht. Die Zahl 90 im Dateinamen ist wichtig: Raspberry Pi OS bringt eine eigene Datei mit dem Präfix 40 mit, und bei widersprüchlichen Einstellungen gewinnt die Datei, deren Name alphabetisch später kommt. Aus demselben Grund ersetzt die Obergrenze von 200 MB eine kleinere, die Du vielleicht schon früher in einer Datei mit niedrigerer Nummer festgelegt hast. Starte den Journal-Dienst neu, damit die Änderung greift:
sudo systemctl restart systemd-journaldOb es geklappt hat, siehst Du nach dem nächsten Neustart: journalctl --list-boots zeigt dann mindestens zwei Einträge. Willst Du die SD-Karte später wieder schonen, löschst Du die Datei mit sudo rm /etc/systemd/journald.conf.d/90-persistent.conf und startest den Dienst erneut. Welche weiteren Einstellungen einem Pi im Dauerbetrieb guttun, zeigt Raspberry Pi im Dauerbetrieb: SD-Karte schonen, stabil laufen.
Platz prüfen und alte Einträge löschen
Wie viel Platz das Journal belegt, zeigt dieser Befehl:
journalctl --disk-usageDie Antwort lautet etwa Archived and active journals take up 56.0M in the file system. Ist es Dir zu viel, löschst Du alles, was älter als zwei Wochen ist:
sudo journalctl --rotate --vacuum-time=2weeks--rotate schließt zuerst die aktuell beschriebene Datei ab, denn aufgeräumt werden nur abgeschlossene Dateien. Statt einer Zeit kannst Du mit --vacuum-size=100M auch eine Größe angeben.
Wenn Du mit der Ausgabe weiterarbeiten willst
Für eine Fehlermeldung in einem Forum oder einem Bugreport kopierst Du die Zeilen am besten ohne die Blätteranzeige:
journalctl -u ssh -b --no-pager -n 50Das gibt die letzten 50 Meldungen des Dienstes aus dem aktuellen Boot direkt im Terminal aus. Mit > ssh-log.txt am Ende des Befehls landen sie in einer Datei, die Du weitergeben kannst. Prüf vorher, ob darin IP-Adressen oder Benutzernamen stehen, die Du nicht teilen möchtest.
Kurz gesagt
Für die meisten Probleme genügen drei Befehle: journalctl -u <dienst> -e für einen streikenden Dienst, journalctl -p err -b für alle Fehler seit dem Start und journalctl -b -1 -e für die Frage, was vor dem letzten Neustart passiert ist. Auf dem Raspberry Pi funktioniert Letzteres erst, wenn Du das Journal dauerhaft speicherst, und genau dieser Schritt ist es, der Dir beim nächsten rätselhaften Neustart die Antwort liefert.
Weiterlesen.
-
Raspberry Pi & LinuxEigenen systemd-Dienst anlegen: Skripte dauerhaft starten
Python-Skript oder Bot als systemd-Dienst: startet beim Booten und nach Absturz neu, schreibt Logs. Mit getesteter Unit-Vorlage und Timer.
Nathan Base -
Raspberry Pi & LinuxRaspberry Pi im Dauerbetrieb: SD-Karte schonen, stabil laufen
Läuft der Raspberry Pi rund um die Uhr, sterben SD-Karten und Netzteile zuerst. Diese Einstellungen unter Raspberry Pi OS Trixie machen den Pi langlebig.
Nathan Base -
Raspberry Pi & LinuxRaspberry Pi 5: Unterspannung und das richtige Netzteil
Unterspannung am Raspberry Pi 5 erkennen: vcgencmd get_throttled Bit für Bit dekodiert, die 5-A-Regel erklärt, usb_max_current_enable richtig genutzt.
Nathan Base -
Raspberry Pi & LinuxLinux-Festplatte voll: große Dateien finden mit ncdu
No space left on device? So findest Du unter Linux mit df, du und ncdu die Speicherfresser, räumst sicher auf und löst auch den Fall gelöschter Dateien.
Nathan Base -
Raspberry Pi & LinuxRaspberry Pi 5 zu heiß? Temperatur, Throttling, Kühlung
Wie heiß darf der Raspberry Pi 5 werden? Grenzwerte, Temperatur messen und loggen, Active Cooler oder Gehäuse, Lüfterkurve anpassen und Stresstest.
Nathan Base -
Raspberry Pi & LinuxRaspberry Pi startet nicht: LED-Blinkcodes und Lösungen
Dein Raspberry Pi bootet nicht? Alle LED-Blinkcodes von Pi 4 und Pi 5 auf Deutsch, dazu Netzteil, SD-Karte, Bootloader und Boot-Reihenfolge prüfen.
Nathan Base