Zum Inhalt springen
SONOYA.com
Raspberry Pi & Linux

Linux-Dateirechte: chmod, chown und Permission denied

Was rwx, 755 und 644 bedeuten und wie Du „Permission denied“ unter Linux und auf dem Raspberry Pi mit chmod, chown und Gruppen löst, ohne chmod 777.

Von

Symbol einer Datei mit Vorhängeschloss als Sinnbild für Linux-Dateirechte, die mit chmod und chown festgelegt werden

„Permission denied“ ist die Meldung, an der fast jeder auf dem Raspberry Pi oder einem Linux-Server früher oder später hängen bleibt: Ein Skript startet nicht, der Webserver kann eine Datei nicht lesen, oder Du darfst auf die externe Platte nicht schreiben. Die Ursache sind fast immer die Linux-Dateirechte. Hier lernst Du, die Rechte mit ls -l zu lesen, sie mit chmod und chown gezielt zu ändern und die typischen Fälle zu lösen, ohne alles mit chmod 777 aufzureißen.

Die Befehle gelten für Raspberry Pi OS (Trixie, auf Basis von Debian 13), Debian und Ubuntu gleichermaßen, weil alle dieselben GNU-coreutils verwenden.

Rechte lesen mit ls -l

Bevor Du etwas änderst, schaust Du nach, was gerade gilt. ls -l zeigt für jede Datei eine Zeile mit den Rechten am Anfang:

Code
ls -l

Eine typische Ausgabe sieht so aus:

Code
-rw-r--r-- 1 pi   pi    21 19. Nov 15:10 skript.sh
drwxr-xr-x 2 pi   pi  4096 19. Nov 15:10 ordner

Die ersten zehn Zeichen sind die Rechte. Das erste Zeichen sagt, was der Eintrag ist: - für eine normale Datei, d für ein Verzeichnis, l für einen symbolischen Link. Danach folgen drei Dreiergruppen:

  • die Rechte des Besitzers (hier rw-),
  • die Rechte der Gruppe (hier r--),
  • die Rechte aller anderen (hier r--).

In jeder Gruppe steht r für Lesen, w für Schreiben und x für Ausführen, ein Strich bedeutet, dass das Recht fehlt. Die beiden Namen hinter der Zahl sind der Besitzer und die Gruppe, hier jeweils pi. Für skript.sh heißt das: Der Besitzer darf lesen und schreiben, alle anderen nur lesen, und ausführen darf die Datei niemand.

Wer Du selbst bist und in welchen Gruppen Du steckst, zeigt Dir id:

Code
id

Linux prüft bei jedem Zugriff der Reihe nach: Bist Du der Besitzer, gelten die Besitzerrechte. Sonst, wenn Du in der Gruppe bist, die Gruppenrechte. Sonst die Rechte für alle anderen. Es greift immer nur genau eine der drei Gruppen.

Bei Verzeichnissen bedeutet x etwas anderes

Bei Ordnern haben die drei Buchstaben eine eigene Bedeutung, und genau hier entstehen viele rätselhafte Fehler:

  • r erlaubt, die Namen der Einträge aufzulisten.
  • w erlaubt, Dateien im Ordner anzulegen, umzubenennen und zu löschen.
  • x erlaubt, den Ordner zu betreten und auf Dateien darin zuzugreifen.

Fehlt das x, hilft ein Leserecht auf die Datei selbst nichts. Ein Ordner mit drw-r--r-- lässt Dich höchstens die Namen sehen, ein cat ordner/datei.txt endet trotzdem mit „Permission denied“. Das gilt auch für jeden übergeordneten Ordner auf dem Pfad: Damit ein Webserver /home/pi/website/index.html lesen kann, braucht er x auf /home, /home/pi und /home/pi/website.

Ein zweiter Punkt überrascht oft: Ob Du eine Datei löschen darfst, entscheidet das w des Ordners, nicht das der Datei.

chmod: Rechte ändern, symbolisch oder als Zahl

chmod ändert die Rechte und kennt zwei Schreibweisen. Die symbolische eignet sich, wenn Du gezielt ein einzelnes Recht hinzufügen oder entfernen willst. Sie besteht aus wem (u Besitzer, g Gruppe, o andere, a alle), einer Operation (+, -, =) und den Rechten:

Code
chmod u+x skript.sh

Dieser Befehl gibt dem Besitzer das Ausführrecht und lässt alles andere unverändert. Mit chmod go-w datei.txt nimmst Du Gruppe und anderen das Schreibrecht, mit chmod go= geheim.txt entziehst Du ihnen alle Rechte.

Die Oktalschreibweise setzt alle drei Gruppen auf einmal. Jedes Recht hat einen Wert: r ist 4, w ist 2, x ist 1. Pro Gruppe addierst Du die Werte und schreibst drei Ziffern hintereinander, für Besitzer, Gruppe und andere. Diese Kombinationen brauchst Du in der Praxis fast immer:

ZahlRechteTypischer Einsatz
644rw-r--r--normale Dateien, Konfiguration, Webseiten
755rwxr-xr-xVerzeichnisse, Skripte und Programme
600rw-------private Dateien wie SSH-Schlüssel oder .env
700rwx------private Verzeichnisse wie ~/.ssh
750rwxr-x---Skripte oder Ordner nur für Besitzer und Gruppe
Code
chmod 644 config.txt

Damit darf der Besitzer config.txt lesen und schreiben, alle anderen nur lesen.

Für ganze Verzeichnisbäume gibt es -R. Dabei ist Vorsicht geboten, denn chmod -R 644 ordner nimmt allen Unterordnern das x, und danach kommt niemand mehr hinein. Das große X löst das: Es setzt das Ausführrecht nur bei Verzeichnissen und bei Dateien, die schon für irgendwen ausführbar sind.

Code
chmod -R u=rwX,go=rX ordner

Das Ergebnis sind 755 für alle Unterordner und 644 für normale Dateien, ohne dass Du Ordner und Dateien getrennt behandeln musst.

chown und chgrp: Besitzer und Gruppe ändern

Manchmal stimmen die Rechte, aber die Datei gehört dem Falschen, etwa weil Du sie mit sudo angelegt hast und sie jetzt root gehört. Den Besitzer ändert nur root, deshalb brauchst Du hier sudo:

Code
sudo chown pi datei.txt

Besitzer und Gruppe setzt Du in einem Rutsch mit Doppelpunkt, für ganze Ordner wieder mit -R:

Code
sudo chown -R pi:pi /home/pi/projekt

Ersetze pi durch Deinen eigenen Benutzernamen, den Dir whoami anzeigt. Nur die Gruppe änderst Du mit chgrp, zum Beispiel sudo chgrp www-data index.html.

Gruppen statt sudo: Zugriff auf Docker, GPIO und Serielle

Viele „Permission denied“-Fehler betreffen gar keine eigenen Dateien, sondern Geräte und Sockets: den Docker-Socket, die GPIO-Pins oder einen USB-Seriell-Adapter unter /dev/ttyUSB0. Diese Dateien gehören einer bestimmten Gruppe, und statt jeden Befehl mit sudo auszuführen, nimmst Du Deinen Benutzer in diese Gruppe auf:

Code
sudo usermod -aG dialout $USER

-aG hängt die Gruppe an die bestehenden an. Das -a ist entscheidend: Ohne es ersetzt usermod alle Zusatzgruppen, und Du verlierst unter Umständen sogar die Gruppe sudo. Die wichtigsten Gruppen sind dialout für serielle Schnittstellen, gpio für die GPIO-Pins des Pi und docker für den Docker-Daemon. Auf Raspberry Pi OS ist der erste Benutzer meist schon in gpio und dialout.

Die neue Gruppe gilt erst nach einer neuen Anmeldung. Melde Dich ab und wieder an oder trenne die SSH-Verbindung und baue sie neu auf, dann prüfst Du mit id, ob die Gruppe auftaucht.

Wichtig bei der Gruppe docker: Wer darin ist, hat laut Docker-Dokumentation faktisch Root-Rechte auf dem System. Auf einem Pi, an dem nur Du arbeitest, ist das in Ordnung, auf einem geteilten Server solltest Du es Dir gut überlegen. Wie Docker auf dem Pi sauber eingerichtet wird, zeigt die Anleitung Docker auf dem Raspberry Pi installieren und nutzen.

sudo ist keine Lösung für Rechteprobleme

sudo führt einen einzelnen Befehl als root aus, und root darf alles. Das ist richtig für Systemaufgaben wie Pakete installieren. Wenn Du aber sudo brauchst, um in Deinem eigenen Projektordner zu arbeiten, stimmt etwas mit Besitzer oder Rechten nicht, und jedes weitere sudo macht es schlimmer, weil die neuen Dateien wieder root gehören. Repariere dann einmal den Besitzer mit chown und arbeite danach ohne sudo weiter.

Die häufigsten Fälle und ihre Lösung

Skript lässt sich nicht starten

./backup.sh antwortet mit „Permission denied“, obwohl die Datei Dir gehört. Es fehlt das Ausführrecht:

Code
chmod u+x backup.sh

Danach zeigt ls -l backup.sh ein x beim Besitzer, und das Skript läuft. Wie ein solches Skript von Grund auf entsteht, erklärt die Linux-Anleitung: Erstes Shell-Script schreiben zur Systemaktualisierung.

Webserver zeigt 403 Forbidden

Apache und Nginx laufen unter Debian und Raspberry Pi OS als Benutzer www-data. Der muss Deine Dateien lesen und alle Ordner auf dem Pfad betreten dürfen. Für eine Website unter /var/www/html setzt Du Besitzer und Rechte so:

Code
sudo chown -R www-data:www-data /var/www/html
sudo chmod -R u=rwX,g=rX,o=rX /var/www/html

Nur Ordner, in die die Anwendung schreiben muss, etwa für Uploads, brauchen zusätzlich w für www-data. Den Rest lässt Du lesend.

Externe Platte mit exFAT oder FAT32

Auf einer Platte mit exFAT, FAT32 oder NTFS wirken chmod und chown nicht oder schlagen mit einer Fehlermeldung fehl, weil diese Dateisysteme keine Linux-Rechte speichern können. Besitzer und Rechte werden hier beim Einhängen festgelegt, über die Mount-Optionen uid, gid und umask in der /etc/fstab. Wie das konkret aussieht, steht in der Anleitung: Externe Festplatte an Raspberry Pi anschließen und unter Raspberry Pi OS mounten. Bleibt die Platte dauerhaft am Pi, ist ext4 die bessere Wahl, dann funktionieren alle Rechte wie gewohnt.

SSH verweigert den Schlüssel

SSH ist absichtlich streng. Ist Dein privater Schlüssel für andere lesbar, bricht der Client mit „UNPROTECTED PRIVATE KEY FILE“ und „Permissions 0644 … are too open“ ab. Auf dem Server ignoriert sshd eine authorized_keys, wenn sie oder ~/.ssh für andere beschreibbar sind, und fragt dann nach dem Passwort. Die passenden Rechte sind:

Code
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519
chmod 600 ~/.ssh/authorized_keys

Den öffentlichen Schlüssel id_ed25519.pub darfst Du mit 644 lassen. Den kompletten Ablauf mit Schlüssel erzeugen und auf den Server kopieren beschreibt SSH-Schlüssel erstellen und nutzen: ed25519 Schritt für Schritt.

Warum chmod 777 keine Lösung ist

Mit chmod 777 darf jeder Benutzer und jeder Dienst auf dem System die Datei lesen, ändern und ausführen. Der Fehler verschwindet, aber Du hast ihn nicht gelöst, sondern die Schutzmauer eingerissen: Ein kompromittierter Dienst könnte Deine Skripte umschreiben, die danach mit Deinen Rechten laufen. SSH verweigert Schlüssel mit solchen Rechten ohnehin, und manche Programme wie sudo prüfen ihre Konfiguration ebenfalls auf zu offene Rechte.

Die saubere Frage lautet immer: Wer muss zugreifen, und was muss er dürfen? Ist es Dein Benutzer, korrigierst Du den Besitzer mit chown. Ist es ein Dienst, gibst Du seiner Gruppe genau das nötige Recht. Ist es ein Gerät, nimmst Du Dich in dessen Gruppe auf.

Ausblick: umask legt die Standardrechte fest

Warum neue Dateien meist 644 und neue Ordner 755 bekommen, regelt die umask. Sie zieht von den Maximalrechten (666 für Dateien, 777 für Ordner) Rechte ab. Den aktuellen Wert zeigt:

Code
umask

Die übliche Ausgabe 0022 nimmt Gruppe und anderen das Schreibrecht. Für normale Anwendungsfälle passt dieser Wert, Du musst ihn nicht ändern.

Fazit

Mit drei Fragen löst Du fast jedes „Permission denied“: Wem gehört die Datei (ls -l), wer bin ich und in welchen Gruppen (id), und darf ich jeden Ordner auf dem Pfad betreten? Danach greifst Du gezielt zu chmod, chown oder usermod -aG, statt alles für alle zu öffnen. Das Verhalten von chmod u+x, chmod go= und einem Ordner ohne x-Recht ist in der Shell nachgestellt, alle Befehle sind gegen die Dokumentation der GNU-coreutils und die Handbuchseiten geprüft. Weitere Grundbefehle für den Alltag findest Du in der kleinen Linux-Befehlsübersicht: die 10 häufigsten Kommandos mit Optionen und Parametern.

Zum Nachlesen: die offizielle GNU-coreutils-Dokumentation zu Dateirechten und die Handbuchseite chmod(1).

Weiterlesen.