Docker में Nextcloud डेटा डायरेक्टरी कहाँ होती है
Docker में Nextcloud फाइलों का सटीक पाथ जानें। यह गाइड आपको कंटेनर के अंदर के /data और /config फोल्डर के साथ होस्ट वॉल्यूम लोकेशन ढूँढने और पूर्ण बैकअप लेने का तरीका बताती है।
Docker में Nextcloud फ़ाइलें कहाँ रखता है
Docker में Nextcloud फ़ाइलें container के अंदर एक data directory में रखता है। आपके server पर इसका वास्तविक स्थान वही होता है, जिसे आपने उससे जोड़े गए volume या bind mount के रूप में निर्धारित किया है। linuxserver.io image में lscr.io/linuxserver/nextcloud user files /data में रहती हैं, और config.php, apps तथा themes /config के अंतर्गत रहती हैं। ये दोनों container paths हैं। एक command इनके पीछे मौजूद host path दिखाती है। इस guide का बाकी हिस्सा प्रश्न के कठिन भाग को समझाता है: data directory में कौन-कौन-सी चीज़ें नहीं होतीं।
Image tag को स्थिर रखें। Paths Nextcloud के बजाय image से संबंधित होते हैं, और floating tag आपके नियंत्रण के बिना बदल सकता है। 20 November 2026 तक वर्तमान stable image release 35.0.3-ls3 है, जिसमें Nextcloud 35.0.3 शामिल है। यह Nextcloud 35 major version की चौथी release है। Image एक बार में केवल एक major version upgrade करती है। इसलिए 34.x पर चल रहा stack एक ही step में 35 पर जाता है। उस step से पहले backup लेना चाहिए।
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:दोनों passwords compose file के पास मौजूद .env file से आते हैं। इसलिए वे compose file में नहीं रहते। उत्तर में कुल तीन volumes हैं। इनमें से केवल एक में user files रहती हैं।
ये container paths केवल इसी image के documentation से लिए गए हैं। कोई दूसरी Nextcloud image filesystem को अलग तरीके से व्यवस्थित कर सकती है और installation को अपने web root के अंतर्गत रख सकती है। इसलिए forum post से copy किया गया path केवल अनुमान है। आप जो container चला रहे हैं, उसी से सही जानकारी पढ़ें।
docker inspect nextcloudउस output का Mounts section हर mount की सूची देता है। इसमें host side पर Source और container side पर Destination दिखता है। आपने जो भी image चुनी हो, यह listing आपके setup के लिए प्रश्न का उत्तर देती है।
वॉल्यूम के पीछे मौजूद वास्तविक host path कैसे खोजें?
Named volume को Docker manage करता है, इसलिए उसका path आप स्वयं तय नहीं करते। आप Docker से उसका path पूछते हैं।
docker volume ls
docker volume inspect nextcloud_nextcloud_dataनाम महत्वपूर्ण है। Docker Compose volume names में project name का prefix जोड़ता है। यह नाम डिफ़ॉल्ट रूप से उस directory के नाम पर आधारित होता है जिसमें आपकी compose file मौजूद है। इसलिए file में nextcloud_data के रूप में लिखा volume आम तौर पर disk पर nextcloud_nextcloud_data के रूप में मौजूद होता है। docker volume ls वास्तविक names दिखाता है। Inspect output संक्षिप्त रूप में इस तरह दिखता है:
[
{
"CreatedAt": "2026-08-18T09:12:44Z",
"Driver": "local",
"Mountpoint": "/var/lib/docker/volumes/nextcloud_nextcloud_data/_data",
"Name": "nextcloud_nextcloud_data",
"Scope": "local"
}
]Mountpoint इसका उत्तर है। Path का अनुमान लगाने के बजाय command से इसे पढ़ें, क्योंकि यह बदल सकता है। Rootless Docker में पूरा Docker data root डिफ़ॉल्ट रूप से daemon चलाने वाले user की home directory के अंदर रहता है। इसलिए यह path किसी दूसरी जगह से शुरू होता है।
Bind mount में यह प्रश्न नहीं रहता। Compose file में - /srv/nextcloud/data:/data लिखें। तब host path वही होगा जो आपने लिखा है। docker inspect इसे Source के रूप में report करता है। यह विकल्प केवल path नहीं बदलता, क्योंकि named volumes और bind mounts ownership और backups के मामले में अलग तरह से काम करते हैं।
डेटा directory backup क्यों नहीं है
Nextcloud manual के अनुसार backup में पाँच चीजें सुरक्षित रहनी चाहिए: config folder, custom apps folder, data folder, theme folder और database। इस image में config, apps और theme folders सभी /config के अंतर्गत हैं, जबकि database अपने volume वाले अलग container में चलता है। केवल /data copy करने पर समस्या का सबसे कम महत्वपूर्ण हिस्सा ही सुरक्षित होता है।
Database महत्वपूर्ण है, क्योंकि web interface किसी directory की सूची नहीं दिखाता। यह file cache से rows दिखाता है। इसी कारण manual में data directory में files को हाथ से copy करने के बाद scan चलाने को कहा गया है। /data को empty database के पास restore करने पर index के बिना केवल bytes मिलते हैं: कोई users नहीं, कोई shares नहीं और file list में कुछ नहीं। Database को empty /data के पास restore करने पर प्रत्येक row ऐसी file की ओर संकेत करती है जो मौजूद नहीं है।
config.php में database credentials और trusted domains होते हैं। इसमें instance id भी होता है। appdata_ prefix लगाने पर यही id app data folder का नाम बनाती है। Memory में रखे किसी भी value पर भरोसा करने के बजाय running instance से पूछें।
docker exec -it nextcloud occ config:system:get datadirectory
docker exec -it nextcloud occ config:system:get instanceidपहली command उस data directory को दिखाती है जिसे यह instance वास्तव में उपयोग करता है। यहाँ वह /data है। इस image में path पर occ wrapper उपलब्ध है, इसलिए इसे सीधे docker exec के माध्यम से चलाएँ। Nextcloud manual में दिया गया लंबा sudo और php occ form copy न करें। वह container के बाहर की installation के लिए लिखा गया है।
डेटा वॉल्यूम चुपचाप किससे भर रहा है?
Previews और प्रत्येक user का history उसी volume में रहते हैं जिसमें files होती हैं। Web interface में user को दिखाई देने वाले storage figure में इनमें से कोई भी शामिल नहीं होता।
- Previews, generated thumbnails होते हैं। ये data directory के अंदर app data folder में रहते हैं। इनका नाम
appdata_से शुरू होता है और उसके बाद instance id होती है। - Deleted files trash में रहती हैं।
trashbin_retention_obligationका default मानautoहै। इससे space उपलब्ध होने पर deleted files 30 दिनों से अधिक समय तक रह सकती हैं। Space की जरूरत होने पर इन्हें 30 दिनों से पहले भी हटाया जा सकता है। Deleted files user की normal quota में शामिल नहीं होतीं, लेकिन trash की अपनी limit होती है: default रूप से user के पास बची quota space का अधिकतम 50%, या quota न होने पर user के लिए उपलब्ध free disk space। जब trash इस limit से अधिक हो जाती है, तो Nextcloud सबसे पुरानी eligible items को पहले हटाता है।autoके अंतर्गत 30 दिनों से कम पुरानी items भी हटाई जा सकती हैं। - Old versions भी बनी रहती हैं।
versions_retention_obligationका default मानautoहै। यह समय के साथ versions की संख्या कम करता है और प्रत्येक time window में सबसे latest version रखता है। Maximum retention period configure होने पर background job उस अवधि से पुरानी versions या ऐसी versions हटाती है जिनकी file अब मौजूद नहीं है। Quota वाले accounts के लिए Versions app, user के पास वर्तमान में free quota space के 50% को target बनाता है। Quota न होने पर यह filesystem की free space का सीधे उपयोग करता है। Space खाली करने की जरूरत होने पर यह सबसे पुरानी versions को पहले हटाता है और कम से कम दो सबसे recent versions रखता है। इसलिए target कोई hard ceiling नहीं है। User द्वारा manually नाम दी गई version को automatic expiration से बाहर रखा जाता है। User उसे manually delete कर सकता है, औरocc versions:cleanupnamed versions को बाकी versions के साथ हटा देता है।
कुछ भी delete करने से पहले measurement करें।
docker exec -it nextcloud sh -c 'du -sh /data/*'
docker exec -it nextcloud sh -c 'du -sh /data/appdata_*'पहली line प्रत्येक user folder और app data folder के लिए एक number देती है। यदि app data का number बड़ा है, तो उसकी preview subdirectory जाँचें। App data में avatars और cached assets भी रहते हैं। नीचे दिए गए cleanup commands documented हैं और इनमें से हर command जानबूझकर data destroy करती है।
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 हर generated preview को हटा देता है। Users द्वारा files खोलने पर Nextcloud इन्हें फिर से generate करता है। इसलिए space धीरे-धीरे फिर भरती है और CPU पर इसका भार पड़ता है। यदि volume किसी बड़े disk problem का केवल एक हिस्सा है, तो पुरानी images और stale build cache आम तौर पर दूसरा हिस्सा होती हैं।
होस्ट पर कॉपी की गई फ़ाइलें Nextcloud में क्यों दिखाई नहीं देतीं?
क्योंकि Nextcloud अपनी file cache directory में नहीं, बल्कि database में पढ़ता है। आपकी copy ने disk पर ऐसी फ़ाइल बनाई जिसकी matching row मौजूद नहीं थी, इसलिए web interface के पास दिखाने के लिए कुछ नहीं था। Manual में इसी स्थिति का उल्लेख है: फ़ाइलों को सीधे data directory में कॉपी करने के बाद scan करना आवश्यक है।
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 --all--path argument data directory के अंदर का layout भी दिखाता है: प्रत्येक user का एक folder उसके username के नाम पर होता है, और उसके अंदर मौजूद files में web interface पर दिखाई देने वाली फ़ाइलें रहती हैं। जब आपको पता हो कि फ़ाइलें कहाँ गई हैं, तब एक path को scan करें। --all सभी users को scan करता है और बड़े instance पर इसमें काफी समय लग सकता है। --unscanned केवल उन फ़ाइलों को process करता है जिन्हें अभी पूरी तरह scan नहीं किया गया है। -v process की जा रही प्रत्येक फ़ाइल को print करता है। इससे ऐसी command के बीच अंतर स्पष्ट होता है जो अटकी हुई लगती है और ऐसी command के बीच जिसे आप monitor कर सकते हैं।
Ownership यह तय करता है कि scan पर्याप्त होगा या नहीं। जिस फ़ाइल पर container user को write करने की अनुमति नहीं है, वह index हो जाती है, लेकिन बाद में move नहीं हो पाती। इसलिए listing सही दिखाई देती है, जबकि web interface से rename या delete करने पर failure होता है।
PUID और PGID सेट करने के बाद writes विफल क्यों होते हैं?
क्योंकि kernel नामों की नहीं, बल्कि संख्याओं की तुलना करता है। PUID और PGID उस numeric user id (uid) और group id (gid) को सेट करते हैं जिसके तहत container process चलती है। host पर मौजूद हर file का भी एक numeric owner होता है। जब ये दोनों संख्याएँ अलग होती हैं, तो write करने की अनुमति नहीं दी जाती, चाहे दोनों तरफ नाम कुछ भी दिख रहे हों।
docker exec -it nextcloud id abc
sudo ls -ln /var/lib/docker/volumes/nextcloud_nextcloud_data/_dataid abc उस uid और gid को print करता है जिसका container वास्तव में उपयोग कर रहा है, जो आपके द्वारा सेट किए गए PUID और PGID ही होते हैं। ls -ln numeric owners को print करता है, और -n महत्वपूर्ण है: साधारण ls -l उन संख्याओं को host की अपनी user list के माध्यम से translate करता है और एक ऐसा नाम दिखाता है जिसका container के अंदर कोई अर्थ नहीं होता। दोनों संख्याओं की तुलना करें।
फिर अनुमान लगाने के बजाय write का परीक्षण करें।
docker exec -u abc -it nextcloud touch /data/writetestएक Permission denied जो /data को नाम देता है, वह पुष्टि है। container के अंदर से ownership को ठीक करें, फिर वही परीक्षण दोबारा चलाएँ।
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/writetestइसे अंदर से करने का एक कारण है। rootless Docker के तहत container के user ids को /etc/subuid में subordinate range के माध्यम से map किया जाता है, इसलिए container के अंदर का uid 1000 host पर एक बहुत बड़े uid से संबंधित होता है। host-side का chown 1000:1000 तब एक ऐसा owner सेट करता है जिसका उपयोग container नहीं कर सकता, और write फिर भी विफल रहता है। container के अंदर chown चलाने से वही mapping लागू होती है जिसका उपयोग स्वयं Nextcloud process करती है, इसलिए संख्याएँ स्वतः ही मेल खा जाती हैं। यही कारण है कि किसी भी अन्य चीज़ को debug करने से पहले PUID और PGID का डिस्क पर मौजूद owner से मेल खाना आवश्यक है।
वास्तविक रूप से restore काम करे, इसके लिए backup कैसे लें?
Database और folders को एक ही समय का लें। Maintenance mode में logins रुक जाते हैं, इसलिए dump और copy के बीच कोई upload नहीं होता।
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 --offध्यान दें कि dump line में क्या नहीं है: -t flag। TTY line endings को फिर से लिखता है। इससे होकर गुजरा SQL dump ऐसे corrupt होता है कि समस्या केवल restore के दौरान पता चलती है। यह भी ध्यान दें कि command line पर दिया गया password command चलने के दौरान ps output में दिखाई देता है। अपने .env file से password को shell में पढ़ने पर उसे shell history में टाइप करने से बचा जा सकता है, लेकिन expanded command-line argument छिपता नहीं है। पुराने database images में mysqldump होता है, mariadb-dump नहीं। Manual दोनों को document करता है।
Restore करने के लिए dump को खाली database में load करें। दोनों archives को fresh volumes में unpack करें। Containers start करें। इसके बाद maintenance mode बंद करें। यदि folders और dump अलग-अलग समय के हों, तो file cache और disk में असंगति रहती है। occ files:scan --all केवल एक दिशा में repair करता है। यह ऐसी files खोज सकता है जो row के बिना मौजूद हैं। लेकिन जिस file की ओर कोई row संकेत करती है, उसे वापस नहीं ला सकता।
Result को server से बाहर रखें। उसी VPS में रखी copy VPS के साथ ही नष्ट हो जाती है। इसलिए इस प्रक्रिया में off-server repository पर restic शामिल होना चाहिए। इसी कारण provider snapshot backup से अलग tool है। यदि आप अभी stack बना रहे हैं, तो VPS पर पूरा Nextcloud install reverse proxy और TLS (transport layer security) certificate को cover करता है। इस guide में इनका विवरण नहीं है।
FAQ
Nextcloud data directory Docker container में कहाँ है?
linuxserver.io image में यह container के अंदर /data पर होती है, और config.php, apps तथा themes /config के अंतर्गत होते हैं। ये container paths हैं। Host path के लिए docker inspect nextcloud चलाएँ और Mounts section में Source value पढ़ें, या volume पर docker volume inspect चलाकर Mountpoint पढ़ें। अन्य Nextcloud images अलग container paths का उपयोग करती हैं, इसलिए pinned tag के documentation की जाँच करें और docker exec -it nextcloud occ config:system:get datadirectory से पुष्टि करें।
Volume में copy की गई files Nextcloud में क्यों नहीं दिखतीं?
Nextcloud directory पढ़ने के बजाय अपने database के file cache से rows दिखाता है। इसलिए Nextcloud के माध्यम से आए बिना जो file आती है, उसकी कोई row नहीं होती और वह दिखाई नहीं देती। एक folder के लिए docker exec -it nextcloud occ files:scan --path="/alice/files/Photos" चलाएँ, या हर user के लिए occ files:scan --all चलाएँ। यदि files दिखाई देती हैं, लेकिन बाद में move या delete नहीं होतीं, तो कारण ownership है: container user के पास उनमें write करने की अनुमति होनी चाहिए।
क्या data volume की copy Nextcloud restore करने के लिए पर्याप्त है?
नहीं। Data volume में file content होता है। Database में file index के साथ users और shares होते हैं, और config.php में database credentials तथा instance id होते हैं। सफल restore के लिए data folder, config folder, database और आपके द्वारा उपयोग किए जाने वाले custom apps तथा theme folders आवश्यक हैं। इन सभी को एक ही समय के snapshot से लें, क्योंकि files से नया database उन files की ओर संकेत करता है जो मौजूद नहीं हैं।
मेरा data volume users को दिखाई देने वाली files से बहुत बड़ा क्यों है?
Previews, deleted files और पुराने versions उसी volume में रहते हैं, और इनमें से कोई भी user को दिखाई देने वाले figure में शामिल नहीं होता। docker exec -it nextcloud sh -c 'du -sh /data/*' से मापें। Default रूप से, space की आवश्यकता होने पर trash can 30 days से पुरानी files delete करता है और आवश्यकता न होने पर उन्हें अधिक समय तक रखता है। Version cleanup quota वाले accounts के लिए बची हुई quota space के आधे हिस्से को target करता है और अन्यथा filesystem की free space का सीधे उपयोग करता है। Recent versions को सुरक्षित रखना target पूरा होने से रोक सकता है। इन्हें occ trashbin:cleanup --all-users, occ versions:cleanup alice और occ preview:cleanup से साफ करें। Users द्वारा अपनी files खोलने पर previews फिर बढ़ने की अपेक्षा रखें।
क्या Nextcloud data directory को किसी दूसरी disk पर ले जा सकता हूँ?
Nextcloud को ज्ञात path बदलने के बजाय नई location को उसी container path पर mount करें। Container रोकें, ownership सुरक्षित रखते हुए पुरानी contents को नई disk पर copy करें (cp -a या rsync -aAX), अपनी compose file में volume या bind mount को नई location पर point करें, फिर container दोबारा start करें। Nextcloud को अब भी /data दिखाई देगा, इसलिए database में किसी row को बदलने की आवश्यकता नहीं होगी। docker exec -it nextcloud occ config:system:get datadirectory और एक test upload से पुष्टि करें।