Waar slaat Nextcloud in Docker bestanden op?
Ontdek de exacte locaties van uw Nextcloud data directory en configuratiebestanden. Leer hoe u het host-pad achterhaalt voor een volledige back-up van uw Docker volumes.
Waar Nextcloud in Docker bestanden opslaat
Nextcloud in Docker slaat bestanden op in een datamap binnen de container. De werkelijke locatie op uw server is het volume of de bind mount die u eraan heeft gekoppeld. Bij de linuxserver.io-image, lscr.io/linuxserver/nextcloud, bevinden gebruikersbestanden zich in /data, en config.php, apps en thema's bevinden zich onder /config. Dit zijn beide containerpaden. Eén commando toont het hostpad daarachter, en de rest van deze handleiding behandelt het moeilijkere deel van de vraag: alles wat de datamap niet bevat.
Pin de image-tag. Paden horen bij een image en niet bij Nextcloud zelf; een zwevende tag kan onverwacht wijzigen. Sinds 20 november 2026 is de huidige stabiele image-release 35.0.3-ls3, die Nextcloud 35.0.3 bevat, de vierde release van de Nextcloud 35 major-versie. De image upgradet slechts één major-versie tegelijk. Een stack die nog op 34.x draait, gaat in één stap naar 35. Die stap verdient vooraf een back-up.
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:De twee wachtwoorden zijn afkomstig uit een .env-bestand naast het compose-bestand, zodat ze buiten het compose-bestand zelf blijven. Dat zijn drie volumes in het antwoord, en slechts één daarvan bevat gebruikersbestanden.
Die containerpaden zijn afkomstig uit de documentatie voor die specifieke image. Een andere Nextcloud-image deelt het bestandssysteem anders in en houdt de installatie onder zijn eigen web-root. Een pad dat u kopieert uit een forumpost is daarom een gok. Lees de werkelijke situatie af van de container die u draait.
docker inspect nextcloudDe Mounts-sectie van die output somt elke mount op, met Source aan de host-zijde en Destination aan de container-zijde. Die lijst beantwoordt de vraag voor uw configuratie, ongeacht welke image u heeft gekozen.
Hoe vind ik het werkelijke hostpad achter het volume?
Een named volume wordt beheerd door Docker, dus u kiest het pad niet zelf. U vraagt het op.
docker volume ls
docker volume inspect nextcloud_nextcloud_dataDe naam is van belang. Docker Compose voegt het project-prefix toe aan volumenamen. Dit is standaard de naam van de map waarin uw compose-bestand staat. Een volume dat in het bestand als nextcloud_data staat geschreven, bestaat op schijf meestal als nextcloud_nextcloud_data. docker volume ls toont de werkelijke namen. De output van inspect ziet er, ingekort, als volgt uit:
[
{
"CreatedAt": "2026-08-18T09:12:44Z",
"Driver": "local",
"Mountpoint": "/var/lib/docker/volumes/nextcloud_nextcloud_data/_data",
"Name": "nextcloud_nextcloud_data",
"Scope": "local"
}
]Mountpoint is het antwoord. Lees dit af van het commando in plaats van er vanuit te gaan, omdat het pad kan wijzigen. Bij rootless Docker bevindt de volledige Docker data root zich standaard in de home-map van de gebruiker die de daemon uitvoert, waardoor dat pad ergens anders begint.
Een bind mount maakt deze vraag overbodig. Schrijf - /srv/nextcloud/data:/data in het compose-bestand en het hostpad is het pad dat u heeft getypt, wat docker inspect rapporteert als de Source. Deze keuze verandert meer dan alleen het pad, omdat named volumes en bind mounts zich verschillend gedragen wat betreft eigenaarschap en back-ups.
Waarom de data-directory geen back-up is
De Nextcloud-handleiding noemt vijf onderdelen die een back-up moet bevatten: de config-map, de map met aangepaste apps, de data-map, de theme-map en de database. Bij deze image bevinden de config-, apps- en theme-mappen zich allemaal onder /config, terwijl de database in een eigen container met een eigen volume draait. Kopieer /data op zichzelf en u heeft het minst interessante deel van het probleem opgeslagen.
De database is van belang omdat de webinterface nooit een directory weergeeft. Deze toont rijen uit de bestandscache; daarom adviseert de handleiding om een scan uit te voeren nadat u handmatig bestanden naar de data-directory heeft gekopieerd. Herstel /data naast een lege database en u heeft bytes zonder index: geen gebruikers, geen shares, niets in de bestandslijst. Herstel de database naast een lege /data en elke rij verwijst naar een bestand dat niet bestaat.
config.php bevat de database-inloggegevens en de vertrouwde domeinen. Het bevat ook de instance id, die de naam van de app-data-map vormt wanneer deze wordt voorafgegaan door appdata_. Vraag het aan de actieve instance in plaats van te vertrouwen op waarden uit uw geheugen.
docker exec -it nextcloud occ config:system:get datadirectory
docker exec -it nextcloud occ config:system:get instanceidDe eerste opdracht toont de data-directory die deze instance daadwerkelijk gebruikt, wat hier /data is. Deze image levert een occ-wrapper op het pad, dus voer het direct uit via docker exec. Kopieer niet de langere sudo- en php occ-vorm uit de Nextcloud-handleiding, aangezien deze is geschreven voor een installatie buiten een container.
Wat vult stilletjes het datavolume?
Previews en de geschiedenis per gebruiker bevinden zich in hetzelfde volume als de bestanden, en geen van beide wordt weergegeven in het opslagcijfer dat een gebruiker in de webinterface ziet.
- Previews zijn gegenereerde miniaturen. Deze staan in de app-datamap binnen de datadirectory, genaamd
appdata_gevolgd door het instance-id. - Verwijderde bestanden blijven in de prullenbak staan.
trashbin_retention_obligationstaat standaard opauto, waardoor verwijderde bestanden langer dan 30 dagen bewaard blijven als er ruimte beschikbaar is, maar ze ook eerder worden verwijderd als er ruimte nodig is. Verwijderde bestanden tellen niet mee voor het normale quotum van de gebruiker, maar de prullenbak heeft een eigen limiet: standaard maximaal 50% van de resterende quotumruimte van een gebruiker, of de vrije schijfruimte voor een gebruiker zonder quotum. Wanneer de prullenbak die limiet overschrijdt, verwijdert Nextcloud eerst de oudste in aanmerking komende items, inclusief items die jonger zijn dan 30 dagen onderauto. - Oude versies blijven ook behouden.
versions_retention_obligationstaat eveneens standaard opauto, wat versies in de loop van de tijd uitdunt en de nieuwste in elk tijdsvenster bewaart; wanneer een maximale bewaartermijn is geconfigureerd, verwijdert een achtergrondtaak versies die die periode overschrijden of waarvan het bestand niet langer bestaat. Voor accounts met een quotum richt de Versions-app zich op 50% van de quotumruimte die een gebruiker momenteel vrij heeft; zonder quotum gebruikt het direct de vrije ruimte van het bestandssysteem. Wanneer er ruimte moet worden vrijgemaakt, verwijdert het eerst de oudste versies, waarbij ten minste de twee meest recente worden bewaard; het doel is dus geen harde bovengrens. Een versie die een gebruiker handmatig een naam heeft gegeven, wordt uitgesloten van die automatische verwijdering, maar de gebruiker kan deze nog steeds handmatig verwijderen, enocc versions:cleanupverwijdert benoemde versies samen met de rest.
Meet de situatie voordat u iets verwijdert.
docker exec -it nextcloud sh -c 'du -sh /data/*'
docker exec -it nextcloud sh -c 'du -sh /data/appdata_*'De eerste regel geeft één getal per gebruikersmap plus de app-datamap. Als het getal voor app-data groot is, controleer dan de preview-submap; app-data bevat ook avatars en gecachte assets. De onderstaande opschooncommando's zijn gedocumenteerd en elk ervan vernietigt bewust gegevens.
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 verwijdert elke gegenereerde preview, en Nextcloud genereert deze opnieuw zodra gebruikers die bestanden openen, waardoor de ruimte geleidelijk terugkomt en de CPU hiervoor de kosten draagt. Als het volume slechts een onderdeel is van een breder schijfprobleem, zijn oude afbeeldingen en verouderde build-cache meestal het andere onderdeel.
Waarom verschijnen bestanden die ik naar de host kopieer niet in Nextcloud?
Omdat Nextcloud de bestandscache uit de database leest en niet direct uit de map. Uw kopieeractie heeft een bestand op de schijf aangemaakt waarvoor geen bijbehorende rij in de database bestaat, waardoor de webinterface niets heeft om weer te geven. De handleiding beschrijft dit specifieke scenario: een scan is vereist nadat bestanden direct naar de datamap zijn gekopieerd.
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 --allHet --path-argument toont ook de structuur binnen de datamap: elke gebruiker heeft een map die vernoemd is naar de gebruikersnaam, en files daarbinnen bevat wat de gebruiker in de webinterface ziet. Scan één pad als u weet waar de bestanden zijn geplaatst. --all doorloopt elke gebruiker en duurt lang bij een grote instantie. --unscanned verwerkt alleen bestanden die als nog niet volledig gescand zijn gemarkeerd. -v toont elk bestand terwijl het wordt verwerkt; dit is het verschil tussen een commando dat vastgelopen lijkt en een proces dat u kunt volgen.
Eigenaarschap bepaalt of de scan voldoende is. Een bestand waarnaar de containergebruiker niet kan schrijven, wordt wel geïndexeerd, maar kan vervolgens niet worden verplaatst. Hierdoor lijkt de lijst in de webinterface correct, maar mislukken acties zoals hernoemen of verwijderen.
Waarom mislukken schrijfacties nadat ik PUID en PGID heb ingesteld?
Omdat de kernel getallen vergelijkt, geen namen. PUID en PGID bepalen het numerieke user id (uid) en group id (gid) waaronder het containerproces wordt uitgevoerd. Elk bestand op de host heeft ook een numerieke eigenaar. Wanneer de twee getallen verschillen, wordt de schrijfactie geweigerd, ongeacht hoe de namen aan beide kanten eruitzien.
docker exec -it nextcloud id abc
sudo ls -ln /var/lib/docker/volumes/nextcloud_nextcloud_data/_dataid abc toont het uid en gid dat de container daadwerkelijk gebruikt; dit zijn de PUID en PGID die u heeft ingesteld. ls -ln toont numerieke eigenaren, en de -n is hierbij van belang: een standaard ls -l vertaalt die getallen via de gebruikerslijst van de host en toont een naam die binnen de container geen betekenis heeft. Vergelijk de twee getallen.
Test de schrijfactie vervolgens in plaats van te gokken.
docker exec -u abc -it nextcloud touch /data/writetestEen Permission denied waarbij /data wordt genoemd, is de bevestiging. Herstel het eigenaarschap vanuit de container en voer de test daarna opnieuw uit.
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/writetestEr is een reden om dit vanuit de container te doen. Bij rootless Docker worden de user ids van de container gemapt via het onderliggende bereik in /etc/subuid, waardoor uid 1000 binnen de container op de host bij een veel hoger uid hoort. Een chown 1000:1000 aan de host-zijde stelt dan een eigenaar in die de container niet kan gebruiken, waardoor de schrijfactie alsnog mislukt. Het uitvoeren van chown binnen de container verloopt via dezelfde mapping die het Nextcloud-proces zelf gebruikt, waardoor de getallen door de constructie altijd overeenkomen. Dit is ook de reden waarom PUID en PGID moeten overeenkomen met de eigenaar op de schijf voordat u met andere vormen van debugging begint.
Hoe maak ik een back-up zodat het herstel ook echt werkt?
Neem de database en de mappen van exact hetzelfde moment. De onderhoudsmodus blokkeert inlogpogingen, zodat er geen uploads plaatsvinden tussen de dump en het kopiëren.
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 --offLet op wat er ontbreekt in de dump-regel: een -t-vlag. Een TTY herschrijft regeleinden, en een SQL-dump die hierdoor is gegaan, raakt op een manier corrupt die u pas ontdekt tijdens het herstel. Let er ook op dat een wachtwoord op een opdrachtregel zichtbaar is in de ps-uitvoer terwijl het commando draait; het inlezen vanuit uw .env-bestand in de shell voorkomt dat het in de shell-geschiedenis terechtkomt, maar verbergt het uitgeschreven argument op de opdrachtregel niet. Oudere database-images leveren mysqldump in plaats van mariadb-dump, en de handleiding documenteert beide.
Om te herstellen, laadt u de dump in een lege database, pakt u beide archieven uit in nieuwe volumes, start u de containers en schakelt u daarna de onderhoudsmodus uit. Als de mappen en de dump van verschillende momenten komen, komen de bestandscache en de schijf niet overeen, en occ files:scan --all repareert slechts één richting. Het vindt bestanden die bestaan zonder bijbehorende rij. Het kan geen bestand terughalen waarnaar een rij verwijst.
Bewaar het resultaat buiten de server. Een kopie die op dezelfde VPS staat, gaat verloren met de VPS zelf. Daarom hoort restic naar een externe repository in deze cyclus thuis, en daarom is een provider-snapshot een ander hulpmiddel dan een back-up. Als u de stack nog aan het opbouwen bent, behandelt een volledige Nextcloud-installatie op een VPS de reverse proxy en het TLS (transport layer security)-certificaat die in deze handleiding buiten beschouwing worden gelaten.
FAQ
Waar bevindt zich de Nextcloud-datamap in een Docker-container?
Bij de linuxserver.io-image is dit /data binnen de container, en config.php, apps en thema's bevinden zich onder /config. Dit zijn containerpaden. Voor het hostpad voert u docker inspect nextcloud uit en leest u de Source-waarde in de Mounts-sectie, of voer docker volume inspect uit op het volume en lees Mountpoint. Andere Nextcloud-images gebruiken andere containerpaden, dus controleer de documentatie voor de tag die u heeft gepind en bevestig dit met docker exec -it nextcloud occ config:system:get datadirectory.
Waarom verschijnen bestanden die ik naar het volume kopieer niet in Nextcloud?
Nextcloud toont rijen uit de bestandscache in zijn database in plaats van de map te lezen. Een bestand dat aankomt zonder via Nextcloud te gaan, heeft geen rij en blijft onzichtbaar. Voer docker exec -it nextcloud occ files:scan --path="/alice/files/Photos" uit voor één map, of occ files:scan --all voor elke gebruiker. Als de bestanden wel verschijnen maar vervolgens niet verplaatst of verwijderd kunnen worden, is de oorzaak het eigenaarschap: de container-gebruiker moet schrijfrechten hebben op deze bestanden.
Is een kopie van het datavolume voldoende om Nextcloud te herstellen?
Nee. Het datavolume bevat de bestandsinhoud. De database bevat de bestandsindex samen met gebruikers en shares, en config.php bevat de database-inloggegevens en het instance-id. Een werkend herstel vereist de datamap, de config-map, de database en de mappen voor aangepaste apps en thema's als u deze gebruikt. Neem ze allemaal van hetzelfde moment; een database die nieuwer is dan de bestanden verwijst naar bestanden die niet bestaan.
Waarom is mijn datavolume veel groter dan de bestanden die mijn gebruikers zien?
Previews, verwijderde bestanden en oude versies bevinden zich in hetzelfde volume en geen van deze verschijnt in het cijfer dat een gebruiker ziet. Meet dit met docker exec -it nextcloud sh -c 'du -sh /data/*'. Standaard verwijdert de prullenbak bestanden vóór 30 dagen wanneer ruimte nodig is, en bewaart deze langer wanneer er voldoende ruimte is; versie-opschoning richt zich op de helft van de resterende quotaruimte voor accounts met een quotum en gebruikt anders direct de vrije ruimte van het bestandssysteem, terwijl het bewaren van recente versies kan voorkomen dat het doel wordt behaald. Verwijder ze met occ trashbin:cleanup --all-users, occ versions:cleanup alice en occ preview:cleanup, en houd er rekening mee dat previews weer groeien naarmate mensen hun bestanden openen.
Kan ik de Nextcloud-datamap naar een andere schijf verplaatsen?
Mount de nieuwe locatie op hetzelfde containerpad in plaats van het pad te wijzigen dat Nextcloud kent. Stop de container, kopieer de oude inhoud naar de nieuwe schijf met behoud van eigenaarschap (cp -a of rsync -aAX), verwijs in uw compose-bestand naar de nieuwe locatie voor het volume of de bind mount, en start de container opnieuw. Nextcloud ziet nog steeds /data, dus geen enkele rij in de database hoeft te worden gewijzigd. Controleer dit met docker exec -it nextcloud occ config:system:get datadirectory en één test-upload.