Nextcloud Docker Speicherort finden
Erfahren Sie, wo Nextcloud im Container Daten ablegt. Wir zeigen Ihnen, wie Sie den Host-Pfad für Volumes identifizieren und welche Konfigurationsdateien für ein Backup nötig sind.
Wo Nextcloud in Docker Dateien speichert
Nextcloud in Docker speichert Dateien in einem Datenverzeichnis innerhalb des Containers. Der tatsächliche Speicherort auf Ihrem Server ist das Volume oder Bind-Mount, das Sie dafür eingebunden haben. Beim linuxserver.io-Image, lscr.io/linuxserver/nextcloud, liegen Benutzerdaten in /data. config.php, Apps und Themes liegen unter /config. Beide Pfade sind Container-Pfade. Ein Befehl gibt den Host-Pfad dahinter aus. Der restliche Teil dieser Anleitung behandelt die schwierigere Hälfte der Frage: alles, was das Datenverzeichnis nicht enthält.
Fixieren Sie den Image-Tag. Pfade gehören zu einem Image und nicht zu Nextcloud. Ein variabler Tag kann sich ändern, ohne dass Sie dies erwarten. Am 20. November 2026 ist 35.0.3-ls3 das aktuelle stabile Image-Release. Es enthält Nextcloud 35.0.3, das vierte Release der Nextcloud-Hauptversion 35. Das Image führt Upgrades nur jeweils um eine Hauptversion durch. Ein Stack auf 34.x wechselt daher in einem einzigen Schritt zu 35. Vor diesem Schritt sollten Sie ein Backup erstellen.
services:
nextcloud:
image: lscr.io/linuxserver/nextcloud:35.0.3-ls3
container_name: nextcloud
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
volumes:
- nextcloud_config:/config
- nextcloud_data:/data
ports:
- 443:443
restart: unless-stopped
nextcloud-db:
image: mariadb:11.8
container_name: nextcloud-db
environment:
- MARIADB_ROOT_PASSWORD=${MARIADB_ROOT_PASSWORD}
- MARIADB_DATABASE=nextcloud
- MARIADB_USER=nextcloud
- MARIADB_PASSWORD=${NEXTCLOUD_DB_PASSWORD}
volumes:
- nextcloud_db:/var/lib/mysql
restart: unless-stopped
volumes:
nextcloud_config:
nextcloud_data:
nextcloud_db:Die beiden Passwörter stammen aus einer .env-Datei neben der Compose-Datei. Dadurch bleiben sie aus der Compose-Datei selbst heraus. Die Antwort enthält somit drei Volumes. Nur eines davon enthält Benutzerdaten.
Diese Container-Pfade stammen aus der Dokumentation genau dieses Images. Ein anderes Nextcloud-Image strukturiert sein Dateisystem anders und legt die Installation unter einem eigenen Webroot ab. Ein aus einem Forenbeitrag übernommener Pfad ist daher nur eine Vermutung. Lesen Sie die tatsächlichen Pfade aus dem Container ab, den Sie ausführen.
docker inspect nextcloudDer Abschnitt Mounts dieser Ausgabe listet jeden Mount auf. Source bezeichnet dabei die Host-Seite und Destination die Container-Seite. Diese Liste beantwortet die Frage für Ihre Konfiguration, unabhängig davon, welches Image Sie gewählt haben.
Wie finde ich den tatsächlichen Host-Pfad hinter dem Volume?
Ein benanntes Volume wird von Docker verwaltet. Sie wählen seinen Pfad daher nicht selbst aus. Sie fragen ihn ab.
docker volume ls
docker volume inspect nextcloud_nextcloud_dataDer Name ist wichtig. Docker Compose versieht Volume-Namen mit dem Projektnamen. Standardmäßig entspricht dieser dem Namen des Verzeichnisses, in dem Ihre Compose-Datei liegt. Ein in der Datei als nextcloud_data angegebenes Volume heißt auf dem Datenträger daher meist nextcloud_nextcloud_data. docker volume ls zeigt die tatsächlichen Namen an. Die Ausgabe von inspect sieht gekürzt so aus:
[
{
"CreatedAt": "2026-08-18T09:12:44Z",
"Driver": "local",
"Mountpoint": "/var/lib/docker/volumes/nextcloud_nextcloud_data/_data",
"Name": "nextcloud_nextcloud_data",
"Scope": "local"
}
]Mountpoint ist die gesuchte Information. Lesen Sie sie mit dem Befehl aus, anstatt sie anzunehmen, weil sich der Pfad ändern kann. Bei rootless Docker liegt das gesamte Docker-Datenverzeichnis standardmäßig im Home-Verzeichnis des Benutzers, der den Daemon ausführt. Der Pfad beginnt dann an einer anderen Stelle.
Bei einem Bind Mount entfällt diese Frage. Schreiben Sie - /srv/nextcloud/data:/data in die Compose-Datei. Der Host-Pfad entspricht dann dem von Ihnen angegebenen Pfad. docker inspect weist ihn als Source aus. Diese Wahl ändert mehr als nur den Pfad, weil sich benannte Volumes und Bind Mounts bei Eigentümern und Backups unterschiedlich verhalten.
Warum das Datenverzeichnis kein Backup ist
Das Nextcloud-Handbuch nennt fünf Bestandteile, die ein Backup enthalten muss: das Konfigurationsverzeichnis, das Verzeichnis für benutzerdefinierte Apps, das Datenverzeichnis, das Theme-Verzeichnis und die Datenbank. Bei diesem Image liegen die Verzeichnisse für Konfiguration, Apps und Themes alle unter /config. Die Datenbank läuft dagegen in einem eigenen Container mit einem eigenen Volume. Wenn Sie nur /data kopieren, sichern Sie den am wenigsten aussagekräftigen Teil des Problems.
Die Datenbank ist wichtig, weil die Weboberfläche kein Verzeichnis auflistet. Sie listet Zeilen aus dem File Cache auf. Deshalb weist das Handbuch an, nach dem manuellen Kopieren von Dateien in das Datenverzeichnis einen Scan auszuführen. Stellen Sie /data neben einer leeren Datenbank wieder her, haben Sie zwar die Bytes, aber keinen Index: keine Benutzer, keine Freigaben und keine Einträge in der Dateiliste. Stellen Sie die Datenbank neben einem leeren /data wieder her, verweist jede Zeile auf eine nicht mehr vorhandene Datei.
config.php enthält die Zugangsdaten für die Datenbank und die vertrauenswürdigen Domains. Außerdem enthält die Datei die Instance-ID. Daraus wird der Name des App-Data-Verzeichnisses gebildet, wenn appdata_ davorgesetzt wird. Fragen Sie die laufende Instanz ab, statt einem der beiden Werte aus dem Gedächtnis zu vertrauen.
docker exec -it nextcloud occ config:system:get datadirectory
docker exec -it nextcloud occ config:system:get instanceidDer erste Befehl gibt das Datenverzeichnis aus, das diese Instanz tatsächlich verwendet. Hier ist das /data. Dieses Image stellt einen occ-Wrapper im Pfad bereit. Führen Sie ihn daher direkt über docker exec aus. Verwenden Sie nicht die längere Form sudo und php occ aus dem Nextcloud-Handbuch. Diese Form ist für eine Installation außerhalb eines Containers vorgesehen.
Was füllt das Daten-Volume unbemerkt?
Vorschaubilder und der Verlauf pro Benutzer liegen im selben Volume wie die Dateien. Beide werden in der Speicherplatzanzeige der Weboberfläche nicht berücksichtigt.
- Vorschauen sind generierte Vorschaubilder. Sie liegen im App-Datenordner innerhalb des Datenverzeichnisses. Der Ordnername beginnt mit
appdata_, gefolgt von der Instanz-ID. - Gelöschte Dateien bleiben im Papierkorb.
trashbin_retention_obligationsteht standardmäßig aufauto. Dadurch können gelöschte Dateien bei verfügbarem Speicher länger als 30 Tage erhalten bleiben. Wenn Speicher benötigt wird, können sie aber auch vor Ablauf von 30 Tagen gelöscht werden. Gelöschte Dateien werden nicht auf das normale Kontingent des Benutzers angerechnet. Der Papierkorb hat jedoch eine eigene Begrenzung: standardmäßig bis zu 50% des Kontingents, das dem Benutzer noch zur Verfügung steht, oder der freie Speicherplatz für einen Benutzer ohne Kontingent. Überschreitet der Papierkorb diese Grenze, entfernt Nextcloud zuerst die ältesten geeigneten Elemente. Unterautobetrifft das auch Elemente, die jünger als 30 Tage sind. - Auch alte Versionen bleiben erhalten.
versions_retention_obligationsteht ebenfalls standardmäßig aufauto. Dadurch werden Versionen mit der Zeit ausgedünnt, wobei in jedem Zeitfenster die jeweils neueste Version erhalten bleibt. Wenn eine maximale Aufbewahrungsdauer konfiguriert ist, entfernt ein Hintergrundjob Versionen nach Ablauf dieses Zeitraums oder Versionen, deren Datei nicht mehr existiert. Bei Konten mit einem Kontingent zielt die Versions-App auf 50% des aktuell freien Kontingents des Benutzers. Ohne Kontingent verwendet sie direkt den freien Speicherplatz des Dateisystems. Wenn Speicher freigegeben werden muss, löscht sie zuerst die ältesten Versionen, behält aber mindestens die beiden neuesten. Das Ziel ist daher keine harte Obergrenze. Eine Version, die ein Benutzer manuell benannt hat, wird von diesem automatischen Ablauf ausgenommen. Der Benutzer kann sie aber weiterhin manuell löschen.occ versions:cleanupentfernt benannte Versionen zusammen mit den übrigen Versionen.
Messen Sie, bevor Sie etwas löschen.
docker exec -it nextcloud sh -c 'du -sh /data/*'
docker exec -it nextcloud sh -c 'du -sh /data/appdata_*'Die erste Zeile gibt für jeden Benutzerordner und für den App-Datenordner jeweils eine Zahl aus. Wenn der Wert für die App-Daten groß ist, prüfen Sie das Unterverzeichnis preview. Die App-Daten enthalten außerdem Avatare und zwischengespeicherte Assets. Die folgenden Bereinigungsbefehle sind dokumentiert. Jeder dieser Befehle löscht Daten absichtlich.
docker exec -it nextcloud occ trashbin:cleanup --all-users
docker exec -it nextcloud occ versions:cleanup alice
docker exec -it nextcloud occ preview:cleanuppreview:cleanup entfernt jede generierte Vorschau. Nextcloud erzeugt sie erneut, sobald Benutzer die entsprechenden Dateien öffnen. Der Speicherplatz wird daher schrittweise wieder belegt, und die CPU wird dadurch belastet. Wenn das Volume nur ein Teil eines größeren Festplattenproblems ist, sind alte Images und veraltete Build-Caches normalerweise der andere Teil.
Warum werden Dateien, die ich auf den Host kopiere, in Nextcloud nicht angezeigt?
Nextcloud liest den Dateicache aus der Datenbank und nicht aus dem Verzeichnis. Durch das Kopieren wurde eine Datei auf der Festplatte angelegt, ohne dass eine passende Datenbankzeile vorhanden ist. Daher gibt es für die Weboberfläche nichts aufzulisten. Das Handbuch beschreibt genau diesen Fall: Nach dem direkten Kopieren von Dateien in das Datenverzeichnis ist ein Scan erforderlich.
docker exec -it nextcloud occ files:scan --path="/alice/files/Photos"
docker exec -it nextcloud occ files:scan --all --unscanned -v
docker exec -it nextcloud occ files:scan --allDas Argument --path zeigt außerdem die Struktur innerhalb des Datenverzeichnisses: Jeder Benutzer hat ein nach seinem Benutzernamen benanntes Verzeichnis. Darin enthält files die Dateien, die der Benutzer in der Weboberfläche sieht. Scannen Sie einen einzelnen Pfad, wenn Sie wissen, wohin die Dateien kopiert wurden. --all durchläuft alle Benutzer und benötigt bei einer großen Instanz viel Zeit. --unscanned verarbeitet nur Dateien, die noch nicht vollständig gescannt wurden. -v gibt jede Datei aus, während sie verarbeitet wird. Dadurch erkennen Sie, ob ein Befehl tatsächlich hängt oder weiterläuft.
Die Besitzrechte entscheiden, ob der Scan ausreicht. Eine Datei, in die der Containerbenutzer nicht schreiben kann, wird zwar indiziert, kann anschließend aber nicht verschoben werden. Die Dateiliste sieht dann korrekt aus, während das Umbenennen oder Löschen über die Weboberfläche fehlschlägt.
Warum schlagen Schreibvorgänge nach dem Setzen von PUID und PGID fehl?
Der Kernel vergleicht Zahlen, keine Namen. PUID und PGID legen die numerische User-ID (uid) und Group-ID (gid) fest, unter denen der Container-Prozess ausgeführt wird. Jede Datei auf dem Host besitzt ebenfalls einen numerischen Eigentümer. Wenn sich die beiden Zahlen unterscheiden, wird der Schreibvorgang verweigert, unabhängig davon, wie die Namen auf der jeweiligen Seite aussehen.
docker exec -it nextcloud id abc
sudo ls -ln /var/lib/docker/volumes/nextcloud_nextcloud_data/_dataid abc gibt die uid und gid aus, die der Container tatsächlich verwendet; dies sind die von Ihnen gesetzten PUID und PGID. ls -ln gibt die numerischen Eigentümer aus, wobei -n entscheidend ist: Ein einfaches ls -l übersetzt diese Zahlen anhand der Benutzerliste des Hosts und zeigt einen Namen an, der innerhalb des Containers keine Bedeutung hat. Vergleichen Sie die beiden Zahlen.
Testen Sie den Schreibvorgang anschließend, anstatt zu raten.
docker exec -u abc -it nextcloud touch /data/writetestEine Permission denied mit der Angabe /data dient als Bestätigung. Korrigieren Sie die Eigentumsrechte innerhalb des Containers und führen Sie den Test erneut aus.
docker exec -u 0 -it nextcloud chown -R abc:abc /data
docker exec -u abc -it nextcloud touch /data/writetest
docker exec -u abc -it nextcloud rm /data/writetestFühren Sie dies aus gutem Grund innerhalb des Containers aus. Bei rootless Docker werden die User-IDs des Containers über den untergeordneten Bereich in /etc/subuid gemappt, sodass uid 1000 innerhalb des Containers auf dem Host einer wesentlich höheren uid entspricht. Ein chown 1000:1000 auf dem Host setzt dann einen Eigentümer, den der Container nicht verwenden kann, weshalb der Schreibvorgang weiterhin fehlschlägt. Die Ausführung von chown innerhalb des Containers durchläuft dasselbe Mapping, das auch der Nextcloud-Prozess selbst verwendet, sodass die Zahlen konstruktionsbedingt übereinstimmen. Dies ist auch der Grund, warum PUID und PGID mit dem Eigentümer auf dem Datenträger übereinstimmen müssen, bevor Sie mit der weiteren Fehlersuche beginnen.
Wie erstelle ich ein Backup, damit die Wiederherstellung tatsächlich funktioniert?
Erfassen Sie die Datenbank und die Verzeichnisse zum selben Zeitpunkt. Der Wartungsmodus verhindert Anmeldungen. Dadurch wird zwischen dem Dump und dem Kopieren kein Upload gespeichert.
docker exec -it nextcloud occ maintenance:mode --on
docker exec nextcloud-db mariadb-dump --single-transaction -u nextcloud -p"$NEXTCLOUD_DB_PASSWORD" nextcloud > nextcloud-sqlbkp.sql
docker run --rm -v nextcloud_nextcloud_data:/data:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-data.tgz -C /data .
docker run --rm -v nextcloud_nextcloud_config:/config:ro -v "$PWD":/backup alpine:3.22 tar czf /backup/nextcloud-config.tgz -C /config .
docker exec -it nextcloud occ maintenance:mode --offBeachten Sie, was in der Dump-Zeile fehlt: ein -t-Flag. Ein TTY schreibt Zeilenenden um. Ein SQL-Dump, der ein TTY durchlaufen hat, ist dadurch beschädigt. Das fällt oft erst bei der Wiederherstellung auf. Beachten Sie außerdem: Ein Passwort in der Befehlszeile ist während der Ausführung in der Ausgabe von ps sichtbar. Wenn Sie es aus Ihrer .env-Datei in die Shell einlesen, müssen Sie es nicht in die Shell-History eingeben. Das verbirgt das erweiterte Befehlszeilenargument jedoch nicht. Ältere Datenbank-Images verwenden mysqldump statt mariadb-dump. Das Handbuch dokumentiert beide Varianten.
Für die Wiederherstellung laden Sie den Dump in eine leere Datenbank. Entpacken Sie beide Archive in neue Volumes. Starten Sie die Container. Deaktivieren Sie anschließend den Wartungsmodus. Wenn die Verzeichnisse und der Dump aus unterschiedlichen Zeitpunkten stammen, stimmen Dateicache und Datenbank nicht überein. occ files:scan --all kann nur eine Richtung reparieren. Das Tool findet Dateien, für die eine Datenbankzeile existiert, die Datei aber nicht. Es kann keine Datei zurückbringen, auf die eine Datenbankzeile verweist.
Bewahren Sie das Ergebnis außerhalb des Servers auf. Eine Kopie innerhalb derselben VPS geht zusammen mit der VPS verloren. Deshalb gehört restic in ein Repository außerhalb des Servers in diesen Ablauf. Ebenso ist ein Provider-Snapshot ein anderes Werkzeug als ein Backup. Wenn Sie den Stack noch aufbauen, beschreibt eine vollständige Nextcloud-Installation auf einer VPS den Reverse Proxy und das TLS-Zertifikat (Transport Layer Security), die in dieser Anleitung nicht behandelt werden.
FAQ
Wo befindet sich das Nextcloud-Datenverzeichnis in einem Docker-Container?
Beim Image von linuxserver.io befindet es sich im Container unter /data. config.php, Apps und Themes liegen unter /config. Das sind Pfade im Container. Für den Host-Pfad führen Sie docker inspect nextcloud aus und lesen den Wert Source im Abschnitt Mounts ab, oder Sie führen docker volume inspect für das Volume aus und lesen Mountpoint ab. Andere Nextcloud-Images verwenden andere Pfade im Container. Prüfen Sie daher die Dokumentation für den von Ihnen festgelegten Tag und bestätigen Sie den Pfad mit docker exec -it nextcloud occ config:system:get datadirectory.
Warum werden Dateien, die ich in das Volume kopiere, in Nextcloud nicht angezeigt?
Nextcloud liest die Einträge aus dem Datei-Cache in der Datenbank, statt das Verzeichnis auszulesen. Eine Datei, die nicht über Nextcloud hinzugefügt wurde, hat daher keinen Eintrag und bleibt unsichtbar. Führen Sie docker exec -it nextcloud occ files:scan --path="/alice/files/Photos" für ein Verzeichnis oder occ files:scan --all für alle Benutzer aus. Wenn die Dateien angezeigt werden, sich aber anschließend nicht verschieben oder löschen lassen, liegt die Ursache an den Besitzrechten: Der Benutzer im Container muss Schreibzugriff auf die Dateien haben.
Reicht eine Kopie des Daten-Volumes aus, um Nextcloud wiederherzustellen?
Nein. Das Daten-Volume enthält die Dateiinhalte. Die Datenbank enthält den Dateiindex sowie Benutzer und Freigaben. config.php enthält die Zugangsdaten für die Datenbank und die Instanz-ID. Für eine funktionierende Wiederherstellung benötigen Sie das Datenverzeichnis, das Konfigurationsverzeichnis, die Datenbank sowie die benutzerdefinierten App- und Theme-Verzeichnisse, falls Sie diese verwenden. Sichern Sie alle Komponenten zum selben Zeitpunkt. Eine Datenbank, die neuer als die Dateien ist, verweist auf Dateien, die nicht vorhanden sind.
Warum ist mein Daten-Volume viel größer als die Dateien, die meine Benutzer sehen?
Vorschaubilder, gelöschte Dateien und alte Versionen befinden sich im selben Volume. Sie erscheinen nicht in der Anzeige, die ein Benutzer sieht. Messen Sie den Speicherbedarf mit docker exec -it nextcloud sh -c 'du -sh /data/*'. Standardmäßig löscht der Papierkorb Dateien vor Ablauf von 30 Tagen, wenn Speicherplatz benötigt wird, und bewahrt sie länger auf, wenn kein Speicherplatz benötigt wird. Die Versionsbereinigung zielt bei Konten mit einem Kontingent auf die Hälfte des verbleibenden Kontingents ab. Andernfalls verwendet sie den freien Speicherplatz des Dateisystems direkt. Das Aufbewahren aktueller Versionen kann verhindern, dass dieses Ziel erreicht wird. Leeren Sie diese Daten mit occ trashbin:cleanup --all-users, occ versions:cleanup alice und occ preview:cleanup. Rechnen Sie damit, dass die Vorschaubilder wieder anwachsen, sobald Benutzer ihre Dateien öffnen.
Kann ich das Nextcloud-Datenverzeichnis auf eine andere Festplatte verschieben?
Binden Sie den neuen Speicherort unter demselben Pfad im Container ein, statt den von Nextcloud bekannten Pfad zu ändern. Stoppen Sie den Container. Kopieren Sie den bisherigen Inhalt mit beibehaltenen Besitzrechten auf die neue Festplatte (cp -a oder rsync -aAX). Verweisen Sie anschließend in Ihrer Compose-Datei mit dem Volume oder Bind-Mount auf den neuen Speicherort. Starten Sie den Container danach erneut. Nextcloud sieht weiterhin /data. Daher muss kein Eintrag in der Datenbank geändert werden. Prüfen Sie den Pfad mit docker exec -it nextcloud occ config:system:get datadirectory und führen Sie einen Test-Upload durch.