Docker Compose tmpfs: Größe, Rechte und Speicherlimit
Permission denied im tmpfs oder ein Scratch-Ordner frisst das Speicherlimit? So setzen Sie size, mode, uid und gid in Compose richtig und prüfen den Mount im Container.
Docker Compose tmpfs: die kurze Antwort
Ein tmpfs in Docker Compose ist ein Dateisystem im Arbeitsspeicher, das Sie an einen Pfad im Container hängen. Für Eigentümer und Rechte nehmen Sie die Kurzform tmpfs: mit uid=, gid= und mode=, denn nur diese Form kennt laut Compose-Spezifikation uid und gid. Die Größe begrenzen Sie mit size=. Sie ersetzt aber kein Speicherlimit: Alles, was im tmpfs liegt, zählt zum Speicherlimit des Containers.
Diese Anleitung ist für zwei typische Situationen geschrieben. Ihr Container läuft als normaler Benutzer, etwa mit UID 1000, und bekommt auf einem tmpfs-Pfad Permission denied. Oder ein Scratch-Verzeichnis wächst und verbraucht den Speicher, den eigentlich die Anwendung braucht. Beide Probleme haben dieselbe Ursache: Ein tmpfs wird mit dem Container neu angelegt, mit eigenen Rechten und mit Speicher aus demselben Limit wie der Prozess.
Was Docker über tmpfs-Mounts dokumentiert
Docker beschreibt tmpfs auf Linux als dritte Speicherart neben Volumes und Bind-Mounts. Die Seite nennt einige Regeln, die Sie kennen sollten, bevor Sie den ersten Mount schreiben:
- Der Mount ist an den Container gebunden. Stoppt der Container, wird der tmpfs-Mount entfernt, und die Dateien darin sind weg.
- Die Funktion gibt es nur, wenn Docker auf Linux läuft.
- Ohne Größenangabe gilt laut der Tabelle für
--mount(Optiontmpfs-size) ein Maximum von 50 % des gesamten RAM des Hosts. Auf einem VPS mit 4 GB RAM darf ein einzelner tmpfs also bis zu 2 GB wachsen. - Der Standardmodus ist laut derselben Tabelle
1777, also für alle beschreibbar. - Daten im tmpfs zählen zum Speicherlimit des Containers. Ein großer
size=-Wert hebt dieses Limit nicht an. - Die Daten können in eine Swap-Datei geschrieben werden und landen so doch auf der Platte.
- Docker kann tmpfs-Mounts nicht zwischen Containern teilen, anders als Volumes und Bind-Mounts.
- Rechte, die Sie auf einem tmpfs setzen, können nach einem Neustart des Containers zurückgesetzt werden. Laut Docker hilft es in manchen Fällen,
uidundgidzu setzen.
Die beiden Standardwerte für Größe und Modus stehen nur in der --mount-Tabelle. Die Tabelle für --tmpfs nennt keine Standardwerte für Größe und Modus. Prüfen Sie deshalb im laufenden Container, was wirklich gilt. Wie das geht, steht weiter unten.
Drei Wege, tmpfs in Docker Compose zu deklarieren
Compose kennt drei Schreibweisen. Sie sehen ähnlich aus, nehmen aber nicht dieselben Optionen an. Das ist der häufigste Grund für Verwirrung.
Die Kurzform tmpfs: auf Service-Ebene
Die Kurzform ist ein Pfad oder ein Pfad mit Optionen nach einem Doppelpunkt. Die Compose-Spezifikation nennt drei Optionen: mode setzt die Rechte, uid den Eigentümer, gid die Gruppe.
services:
app:
image: alpine:3.21
command: sleep infinity
user: "1000:1000"
tmpfs:
- /run
- /scratch:size=64m,uid=1000,gid=1000,mode=0750size= steht nicht in der Optionsliste der Compose-Spezifikation. Es funktioniert trotzdem, und zwar aus folgendem Grund. Compose (geprüft im Quellcode von v5.8.0) prüft den Text nach dem Doppelpunkt nicht. Es trennt am ersten Doppelpunkt und gibt den Rest unverändert an die Docker Engine weiter. Die Engine bekommt damit dasselbe Feld wie bei docker run --tmpfs. Für diese Option sagt die Docker-Referenz, dass die Optionen identisch mit denen von mount -t tmpfs -o sind. Die --tmpfs-Tabelle listet size, mode, uid, gid sowie exec und noexec. Dass Compose hier exakt dasselbe tut wie --tmpfs, ist unsere Lesart des Quellcodes und kein Satz aus der Doku. Prüfen Sie das Ergebnis daher mit /proc/mounts.
Ein Tippfehler in der Optionsliste fällt Compose deshalb nicht auf. Er fällt erst der Engine oder dem Kernel auf, wenn der Container startet.
Die Langform unter volumes: mit type: tmpfs
Die Langform hängt den tmpfs als Eintrag unter volumes: ein. Sie hat genau zwei tmpfs-Optionen: size in Bytes (als Zahl oder mit Einheit) und mode als oktale Unix-Rechte.
services:
app:
image: alpine:3.21
command: sleep infinity
volumes:
- type: tmpfs
target: /scratch
tmpfs:
size: 64m
mode: 0770uid und gid gibt es hier nicht. Das JSON-Schema der Compose-Spezifikation erlaubt unter tmpfs nur size und mode und verbietet weitere Schlüssel. Auch der Compose-Code (v5.8.0) übergibt an die Engine nur Größe und Modus. Wer einen bestimmten Eigentümer braucht, nimmt also die Kurzform.
Ein benanntes Volume mit driver_opts type=tmpfs
Die dritte Form ist ein benanntes Volume auf dem local-Treiber, das der Treiber als tmpfs einhängt. Die Referenz zu docker volume create zeigt dafür dieses Beispiel:
docker volume create --driver local \
--opt type=tmpfs \
--opt device=tmpfs \
--opt o=size=100m,uid=1000 \
fooDie Compose-Referenz für Volumes sagt, dass die Schlüssel type, o und device unter driver_opts an den local-Treiber durchgereicht werden. In Compose sieht dasselbe Volume so aus:
services:
app:
image: alpine:3.21
command: sleep infinity
volumes:
- scratch:/scratch
volumes:
scratch:
driver: local
driver_opts:
type: tmpfs
device: tmpfs
o: "size=100m,uid=1000"Nach docker compose up -d zeigt docker volume inspect die Optionen, die beim Treiber angekommen sind. Compose stellt dem Namen den Projektnamen voran, also heißt das Volume zum Beispiel myproject_scratch. Ob mehrere Container über so ein Volume dieselben Dateien sehen, beantwortet keine der Docker-Seiten, die wir geprüft haben. Die tmpfs-Seite sagt nur, dass tmpfs-Mounts nicht geteilt werden können. Wenn Sie das brauchen, testen Sie es auf Ihrem System, bevor Sie sich darauf verlassen. Den Unterschied zwischen benannten Volumes und Bind-Mounts erklärt der Beitrag benannte Volumes oder Bind-Mounts in Docker Compose.
Warum meldet der Container „Permission denied“ auf dem tmpfs?
Ein tmpfs bekommt Eigentümer und Modus aus seinen Mount-Optionen. Verlassen Sie sich nicht darauf, dass er die Rechte des Verzeichnisses aus dem Image hat. Läuft Ihr Prozess als UID 1000 und gehört der Mount UID 0 mit Modus 755, darf nur root dort schreiben. Der Prozess bekommt dann Permission denied.
So sehen Sie den Zustand direkt:
docker compose exec app stat -c '%u:%g %a' /scratch
docker compose exec app idDie erste Zeile zeigt Eigentümer, Gruppe und Modus des Mount-Punkts. Die zweite zeigt, als wer der Prozess läuft. Passen die beiden nicht zusammen und fehlt das Schreibrecht für „andere“, ist das die Ursache.
Die häufigsten Auslöser:
- Sie haben in der Langform
mode: 0755odermode: 0750gesetzt. Die Langform kann keinen Eigentümer setzen, also schreibt ein Benutzer ohne root-Rechte dort nichts. - Sie haben in der Kurzform
mode=gesetzt, aberuid=undgid=vergessen. - Die Rechte waren nach dem ersten Start richtig und sind nach einem Neustart anders. Docker nennt das ausdrücklich als bekannte Einschränkung.
Die robuste Lösung ist in allen drei Fällen dieselbe: Kurzform, mit der UID und GID des Prozesses.
tmpfs:
- /scratch:size=64m,uid=1000,gid=1000,mode=0700Welche UID Ihr Image wirklich nutzt, steht oft in PUID und PGID oder in der user:-Zeile. Der Beitrag PUID und PGID in Docker erklärt zeigt, wie Sie das herausfinden. Wenn Sie die Oktalzahlen selbst lesen wollen, hilft chmod mit Zahlen und mit Buchstaben.
Wie prüfe ich, womit der tmpfs wirklich gemountet ist?
Verlassen Sie sich nicht auf die YAML-Datei. Sie zeigt nur, was Sie geschrieben haben. Was der Kernel gemountet hat, zeigt der Container selbst:
docker compose exec app grep /scratch /proc/mountsDie Zeile zeigt den Dateisystemtyp und die Mount-Optionen, mit denen der Kernel den Pfad eingehängt hat. Dort sehen Sie, ob size, mode, uid und gid angekommen sind, und ob Flags wie noexec, nosuid oder nodev gesetzt sind. Ob diese Flags bei Docker Standard sind, beantwortet die Docker-Doku nicht. Lesen Sie es deshalb in dieser Zeile ab, statt es anzunehmen.
Docker selbst zeigt die Mounts auch an:
docker inspect $(docker compose ps -q app) --format '{{ json .Mounts }}'Wie Sie eine Shell im Container öffnen, um länger zu suchen, steht in eine interaktive Shell mit docker compose exec.
Warum frisst ein tmpfs das Speicherlimit des Containers?
Ein tmpfs liegt im RAM. Docker rechnet diesen Speicher dem Container zu. Die Doku sagt dazu zwei Sätze: Daten im tmpfs zählen zum Speicherlimit des Containers, und ein großer size=-Wert hebt dieses Limit nicht an. Das folgende Beispiel ist deshalb ein Widerspruch:
services:
worker:
image: alpine:3.21
command: sleep infinity
mem_limit: 256m
tmpfs:
- /scratch:size=1gsize=1g erlaubt dem tmpfs 1 GB. Das Limit des Containers bleibt 256 MB, und darin müssen auch der Prozess und seine Daten Platz finden. Je voller /scratch wird, desto weniger Speicher bleibt der Anwendung. Setzen Sie size= deshalb deutlich unter das Speicherlimit, zum Beispiel size=64m bei mem_limit: 256m. Dann stößt ein volles Scratch-Verzeichnis zuerst an seine eigene Grenze.
Den Verbrauch sehen Sie live:
docker stats --no-streamDie Spalte MEM USAGE / LIMIT zeigt, wie nah der Container an seinem Limit ist. Wurde ein Container beendet und Sie vermuten den Speicher als Ursache, fragen Sie Docker direkt:
docker inspect --format '{{.State.OOMKilled}}' $(docker compose ps -aq worker)Wie Sie Limits in Compose setzen und was beim Erreichen passiert, erklärt Speicherlimits in Docker Compose.
Ein zweiter Punkt betrifft vertrauliche Daten. Docker schreibt, dass Daten im tmpfs in eine Swap-Datei geschrieben werden können. Ein tmpfs garantiert also nicht, dass ein Schlüssel nie auf der Platte landet. Ob Ihr VPS überhaupt Swap hat, klärt braucht Ihr VPS Swap.
Wie führe ich Programme in einem tmpfs aus?
Manche Werkzeuge entpacken Hilfsprogramme in ein temporäres Verzeichnis und starten sie dort. Ist der tmpfs mit noexec gemountet, scheitert das mit Permission denied, obwohl Eigentümer und Modus stimmen. Prüfen Sie zuerst mit grep /scratch /proc/mounts, ob noexec in der Zeile steht. Steht es dort, setzen Sie in der Kurzform exec:
tmpfs:
- /build:exec,size=256m,uid=1000,gid=1000,mode=0700Die --tmpfs-Tabelle der Docker-Doku beschreibt exec als Option, die das Ausführen von Programmen im Dateisystem erlaubt, und noexec als das Gegenteil. Die Langform unter volumes: kennt diese Option nicht, weil sie nur size und mode annimmt. Prüfen Sie nach dem Neustart erneut mit /proc/mounts, dass noexec verschwunden ist.
Fehler „Additional property mode is not allowed“
Ältere Compose-Versionen lehnen mode in der Langform ab. Die Meldung lautet:
services.foo.volumes.0.tmpfs Additional property mode is not allowedDas ist das Issue compose#9873. Es wurde mit Docker Compose v2.6.0 gemeldet. Die Ursache war das Schema: Es kannte mode unter tmpfs noch nicht. Die Korrektur kam im Dezember 2022, und die Compose-Spezifikation nennt v2.14.0 als die Version, in der mode für die Langform eingeführt wurde. Die Lösung ist also eine neuere Compose-Version. Prüfen Sie Ihre Version:
docker compose versionDie aktuelle Version ist v5.8.0, veröffentlicht am 17. November 2026 (Stand 22. November 2026). Wenn Sie nicht aktualisieren können, nehmen Sie die Kurzform mit mode=. Dort steht mode= im Optionstext eines Listeneintrags und nicht im Objekt unter volumes.0.tmpfs, das die Fehlermeldung nennt.
Ein Hinweis aus derselben Diskussion: Ein Docker-Entwickler war sich nicht sicher, ob mode bei verschachtelten tmpfs-Pfaden voll funktioniert. Für normale, nicht verschachtelte Mounts gelten Rechte als unterstützt. Verschachteln Sie tmpfs-Mounts, prüfen Sie die Rechte also mit stat.
Härtung: read_only: true plus tmpfs
Ein gutes Muster für Dienste, die keine Dateien im Image ändern müssen: Sie machen das Dateisystem des Containers schreibgeschützt und geben nur einzelne Pfade als tmpfs frei. Die Compose-Spezifikation beschreibt read_only so, dass der Container mit einem schreibgeschützten Dateisystem angelegt wird.
services:
app:
image: alpine:3.21
command: sleep infinity
user: "1000:1000"
read_only: true
mem_limit: 256m
tmpfs:
- /tmp:size=32m,mode=1777
- /var/cache/app:size=64m,uid=1000,gid=1000,mode=0700Schreibt die Anwendung dann an eine Stelle, die Sie nicht freigegeben haben, scheitert das sofort. So finden Sie schnell heraus, wohin ein Dienst wirklich schreibt. Testen Sie beide Seiten nach dem Start:
docker compose exec app sh -c 'touch /tmp/probe && echo tmp-ok'
docker compose exec -u 0 app sh -c 'touch /etc/probe && echo etc-ok'Der erste Befehl sollte tmp-ok ausgeben. Der zweite läuft als root, damit fehlende Benutzerrechte das Ergebnis nicht verfälschen. Er sollte trotzdem scheitern, und die Meldung sollte Read-only file system nennen, weil /etc im schreibgeschützten Dateisystem liegt. Klappt der erste Befehl nicht, ist der tmpfs nicht gemountet oder hat die falschen Rechte. Die Docker-Doku sagt nicht ausdrücklich, dass tmpfs-Pfade unter read_only: true beschreibbar bleiben. Dieser Test ist der Nachweis.
Ist /tmp im Container ein tmpfs, wenn der Host Ubuntu 26.04 nutzt?
Nein, nicht automatisch. Die Release Notes von Ubuntu 26.04 LTS schreiben, dass /tmp jetzt standardmäßig ein tmpfs ist, weil Ubuntu die upstream-Unit tmp.mount von systemd mitliefert. Die Notes ordnen diese Änderung Ubuntu 24.10 zu. Das gilt für das /tmp des Hosts. Ein Container sieht dieses Verzeichnis nicht. Sein /tmp liegt im Dateisystem des Containers, also im Image und in seiner beschreibbaren Schicht, solange Sie keinen tmpfs dafür deklarieren. Prüfen Sie es im Container:
docker compose exec app grep ' /tmp ' /proc/mountsGibt der Befehl keine Zeile aus, ist /tmp dort kein eigener Mount. Wollen Sie /tmp im RAM, schreiben Sie es wie im Härtungsbeispiel in die tmpfs:-Liste, mit einer eigenen Größe.
FAQ
Welche Compose-Form akzeptiert uid und gid für tmpfs?
Nur die Kurzform tmpfs: auf Service-Ebene, zum Beispiel - /scratch:size=64m,uid=1000,gid=1000,mode=0700. Die Langform unter volumes: mit type: tmpfs kennt nur size und mode. Das Schema der Compose-Spezifikation verbietet dort weitere Schlüssel. Ein benanntes Volume mit driver_opts nimmt uid= in der o-Zeile an, wie im Beispiel o=size=100m,uid=1000 der Docker-Referenz.
Wie groß wird ein tmpfs ohne size-Angabe?
Die Docker-Doku nennt für --mount ein Maximum von 50 % des gesamten RAM des Hosts, wenn keine Größe gesetzt ist. Unabhängig davon zählt der Inhalt zum Speicherlimit des Containers. Setzen Sie size= immer selbst und deutlich unter mem_limit. Prüfen Sie den Wert mit docker compose exec <service> grep <pfad> /proc/mounts.
Warum ist mein tmpfs nach einem Neustart wieder leer?
Weil ein tmpfs an den Container gebunden ist. Docker entfernt den Mount, wenn der Container stoppt, und die Dateien darin werden nicht gespeichert. Daten, die einen Neustart überleben sollen, gehören in ein Volume oder einen Bind-Mount. Docker nennt außerdem als bekannte Einschränkung, dass Rechte auf einem tmpfs nach einem Neustart zurückgesetzt werden können. Setzen Sie deshalb uid und gid in der Kurzform.
Ist ein tmpfs sicher für Passwörter und Schlüssel?
Nur teilweise. Die Daten liegen im RAM und verschwinden, wenn der Container stoppt. Docker schreibt aber, dass sie in eine Swap-Datei geschrieben werden und so auf der Platte landen können. Hat Ihr Host Swap, ist ein tmpfs kein Beweis dafür, dass ein Geheimnis nie gespeichert wurde. Setzen Sie außerdem einen engen Modus wie 0700 und den passenden Eigentümer, denn der dokumentierte Standardmodus 1777 erlaubt jedem Benutzer im Container das Schreiben.