mkdir

Was mkdir macht

mkdir legt ein neues, leeres Verzeichnis im Dateisystem an. Der Befehl gehört zu den GNU-Coreutils und ist auf jedem Linux-System verfügbar. Im Erfolgsfall erscheint kein Output — mkdir arbeitet nach dem Unix-Prinzip „no news is good news”.

mkdir projekte

Existiert das Verzeichnis bereits oder fehlt das übergeordnete Verzeichnis, schlägt der Befehl mit einer Fehlermeldung und einem Exit-Code ungleich Null fehl — beides löst die Option -p auf elegante Weise.

Syntax und Optionen

mkdir [OPTION]... VERZEICHNIS...

Die wichtigsten Optionen im Überblick:

mkdir docs build dist

-p ist dein Freund

Ohne -p musst du jede Verzeichnis-Ebene einzeln anlegen — und der Befehl scheitert, sobald eine Zwischenebene fehlt. -p löst beide Probleme: Fehlende Eltern werden automatisch mit angelegt, existierende Verzeichnisse werden ignoriert.

mkdir -p projekt/src/utils

In Kombination mit der Bash-Brace-Expansion wird -p zum Strukturgenerator. Folgender Befehl legt in einem Schritt ein komplettes Projektgerüst an:

mkdir -pv projekt/{src,test,docs}/{a,b}

mkdir: created directory 'projekt'
mkdir: created directory 'projekt/src'
mkdir: created directory 'projekt/src/a'
mkdir: created directory 'projekt/src/b'
mkdir: created directory 'projekt/test'
mkdir: created directory 'projekt/test/a'
mkdir: created directory 'projekt/test/b'
mkdir: created directory 'projekt/docs'
mkdir: created directory 'projekt/docs/a'
mkdir: created directory 'projekt/docs/b'

Die Brace-Expansion {src,test,docs} wird von der Shell zu drei Pfaden expandiert, kombiniert mit {a,b} ergeben sich neun Endverzeichnisse — mkdir -p legt alles inklusive der Zwischenebenen an. Mehr dazu im Artikel zur Brace-Expansion.

Permissions beim Anlegen

Standardmäßig erhält ein neues Verzeichnis den Modus 0777 & ~umask. Mit dem typischen umask-Wert 022 ergibt das 0755 — Eigentümer darf alles, Gruppe und andere dürfen lesen und betreten. Welcher umask-Wert in deiner Shell aktiv ist, klärt der Artikel zur Umgebung, das Berechtigungsmodell selbst beschreibt der Artikel zu Berechtigungen.

Mit -m setzt du den Modus direkt — die umask wird dabei ignoriert:

mkdir -m 700 geheim
ls -ld geheim

drwx------ 2 user user 4096 May  5 14:22 geheim

-m akzeptiert sowohl oktale Notation (700, 0755) als auch symbolische (u=rwx,g=,o= oder u+rwx,go-rwx). Praktisch für Konfig- und Schlüssel-Verzeichnisse wie ~/.ssh, die strikt 0700 erfordern.

Stille Fehler und Idempotenz

Ohne -p ist mkdir strikt: Existiert das Verzeichnis schon, gibt es einen Fehler und einen Exit-Code ungleich Null. In Skripten ist das oft unerwünscht — du willst, dass das Verzeichnis hinterher existiert, egal ob es vorher schon da war.

mkdir cache
mkdir cache
echo $?

mkdir: cannot create directory 'cache': File exists
1

Mit -p ist der Befehl idempotent: Mehrfache Aufrufe haben dasselbe Ergebnis wie ein einziger, kein Fehler bei vorhandenem Verzeichnis. Genau das macht -p zur Standard-Wahl in Shell-Skripten:

mkdir -p cache
mkdir -p cache
echo $?

0

Praxis-Beispiele

Typische Muster aus dem Alltag:

mkdir -p src/{utils,components,api,hooks}

Brace-Expansion erzeugt vier Pfade auf einmal — src/utils, src/components, src/api, src/hooks. Mit -p legt mkdir auch das src selbst an, falls es noch nicht existiert. Eine Shell-Zeile statt vier mkdir-Aufrufen.

LOG_DIR="/var/log/myapp"
mkdir -p "$LOG_DIR"
echo "$(date) Start" >> "$LOG_DIR/app.log"

Das Skript darf beliebig oft laufen, ohne dass mkdir -p daran scheitert, dass $LOG_DIR schon existiert. Die doppelten Anführungszeichen um ${LOG_DIR} sind Pflicht, sobald der Pfad Leerzeichen enthalten könnte.

mkdir -p ~/.config/myapp

Standard-Pattern beim Erststart einer Anwendung, die XDG-konform ihre Konfiguration unter ~/.config/ ablegt. -p legt sowohl .config als auch myapp an, falls eines davon fehlt — kein Crash, falls beide schon da sind.

mkdir -p backup/$(date +%Y/%m/%d)

Die Command-Substitution $(date +%Y/%m/%d) liefert Pfade wie 2026/05/04. Zusammen mit -p entsteht eine sortierbare Verzeichnisbaum-Hierarchie für tägliche Backups, die sich später bequem mit find -mtime aufräumen lässt.

mkdir -m 700 -p ~/.ssh

~/.ssh muss zwingend 0700 haben, sonst verweigert OpenSSH die Nutzung von Privatschlüsseln. -m 700 setzt den Modus direkt beim Anlegen, unabhängig vom aktiven umask — sicherer als ein nachträgliches chmod, weil zwischen mkdir und chmod keine Lücke offen bleibt.

Weiterführende Ressourcen

Externe Quellen

• mkdir(1) — Linux man-page — Vollständige Optionsliste und Verhalten
• GNU Coreutils: mkdir invocation — Detaillierte Dokumentation der GNU-Variante
• mkdir(2) — Systemcall — Der zugrundeliegende Kernel-Aufruf
• Arch Wiki: File permissions and attributes — Hintergrund zu Modi, umask und Sonderrechten
• POSIX-Spezifikation: mkdir — Was portabel funktioniert

Verwandte Artikel

• rm und rmdir — Verzeichnisse entfernen — Das Gegenstück zu mkdir
• touch — leere Dateien anlegen — Das Pendant für Dateien
• cd — Verzeichnis wechseln — Navigation im neu angelegten Verzeichnis
• Brace-Expansion — Strukturen in einem Schritt generieren
• Berechtigungen — Modus, Eigentümer und das Unix-Sicherheitsmodell