Docker-এ Nextcloud ফাইল কোথায় জমা থাকে?
Docker কন্টেইনারে Nextcloud ডেটা ডিরেক্টরি এবং হোস্ট ভলিউম পাথ খুঁজে বের করুন। ব্যাকআপের জন্য প্রয়োজনীয় কনফিগারেশন ফাইল ও ডাটাবেস পাথসহ সম্পূর্ণ গাইডটি এখানে দেখুন।
Nextcloud Docker-এ ফাইল কোথায় সংরক্ষণ করে
Nextcloud Docker-এ ফাইলগুলো container-এর একটি data directory-তে সংরক্ষণ করে। আপনার server-এ এর প্রকৃত অবস্থান নির্ভর করে আপনি কোন volume বা bind mount সংযুক্ত করেছেন তার ওপর। linuxserver.io image-এ, lscr.io/linuxserver/nextcloud, user file থাকে /data-এ, এবং config.php, apps ও themes থাকে /config-এর অধীনে। এগুলো দুটিই container path। একটি command এগুলোর পেছনে থাকা host path দেখায়। এই guide-এর বাকি অংশে প্রশ্নটির কঠিন দিকটি ব্যাখ্যা করা হয়েছে: data directory-তে যা থাকে না, তা কোথায় থাকে।
Image tag নির্দিষ্ট করে দিন। Path Nextcloud-এর পরিবর্তে image-এর সঙ্গে সম্পর্কিত, এবং floating tag আপনার অজান্তে পরিবর্তিত হতে পারে। November 20, 2026 অনুযায়ী বর্তমান stable image release হলো 35.0.3-ls3। এতে Nextcloud 35.0.3 রয়েছে, যা Nextcloud 35 major version-এর fourth release। Image একবারে শুধু একটি major version upgrade করে। তাই 34.x-এ থাকা stack এক ধাপে 35-এ যাবে। সেই ধাপের আগে 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:দুটি password compose file-এর পাশে থাকা একটি .env file থেকে নেওয়া হয়। ফলে password-গুলো compose file-এর ভেতরে থাকে না। উত্তরে মোট তিনটি volume আছে, কিন্তু user file রাখে তাদের মধ্যে মাত্র একটি।
এই container path-গুলো শুধু ওই 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-ই বেছে নিন না কেন, এই তালিকাই আপনার setup-এর প্রশ্নটির উত্তর দেয়।
ভলিউমের পেছনের প্রকৃত host path কীভাবে খুঁজে পাব?
একটি named volume Docker দ্বারা পরিচালিত হয়, তাই এর path আপনি নির্ধারণ করেন না। আপনি Docker-এর কাছ থেকে path জেনে নেন।
docker volume ls
docker volume inspect nextcloud_nextcloud_dataনামটি গুরুত্বপূর্ণ। Docker Compose volume name-এর আগে project name যোগ করে। এই project name-এর default মান হলো আপনার compose file থাকা directory-এর নাম। তাই file-এ nextcloud_data হিসেবে লেখা volume সাধারণত disk-এ nextcloud_nextcloud_data নামে থাকে। প্রকৃত নামগুলো docker volume ls দেখায়। সংক্ষেপিত 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-এর output থেকে পড়ুন, কারণ এটি পরিবর্তিত হতে পারে। rootless Docker ব্যবহার করলে সম্পূর্ণ Docker data root defaultভাবে daemon চালানো user-এর home directory-এর ভিতরে থাকে। তাই সেই path অন্য স্থান থেকে শুরু হয়।
একটি bind mount ব্যবহার করলে এই প্রশ্ন থাকে না। compose file-এ - /srv/nextcloud/data:/data লিখুন। তখন host path হবে আপনার লেখা path, যা docker inspect-এ Source হিসেবে দেখানো হয়। এই পছন্দ শুধু path পরিবর্তন করে না, কারণ named volume এবং bind mount ownership ও backup-এর ক্ষেত্রে ভিন্নভাবে কাজ করে।
ডেটা ডিরেক্টরি কেন ব্যাকআপ নয়
Nextcloud manual অনুযায়ী, একটি ব্যাকআপে পাঁচটি জিনিস রাখতে হয়: config folder, custom apps folder, data folder, theme folder এবং database। এই image-এ config, apps এবং theme folder সবই /config-এর অধীনে থাকে, আর database নিজস্ব volume-সহ আলাদা container-এ চলে। শুধু /data কপি করলে সমস্যার সবচেয়ে কম গুরুত্বপূর্ণ অংশই সংরক্ষিত হয়।
Database গুরুত্বপূর্ণ, কারণ web interface কোনো directory-এর তালিকা দেখায় না। এটি file cache-এর row দেখায়। তাই manual-এ data directory-তে হাতে file কপি করার পরে scan চালাতে বলা হয়েছে। খালি database-এর পাশে /data restore করলে index ছাড়া শুধু bytes থাকবে: কোনো user, share বা file list থাকবে না। আবার খালি /data-এর পাশে database restore করলে প্রতিটি row এমন একটি file-এর দিকে নির্দেশ করবে, যা আর নেই।
config.php-এ database credential এবং trusted domain থাকে। এতে instance id-ও থাকে। appdata_-এর সঙ্গে prefix করলে এই id app data folder-এর নাম তৈরি করে। স্মৃতির ওপর নির্ভর না করে চলমান instance-কে জিজ্ঞেস করুন।
docker exec -it nextcloud occ config:system:get datadirectory
docker exec -it nextcloud occ config:system:get instanceidপ্রথম command-টি এই instance যে data directory প্রকৃতপক্ষে ব্যবহার করছে, সেটি দেখায়। এখানে সেটি /data। এই image-এ path-এ একটি occ wrapper রয়েছে, তাই সরাসরি docker exec-এর মাধ্যমে এটি চালান। Nextcloud manual-এ দেওয়া দীর্ঘ sudo এবং php occ form কপি করবেন না। সেটি container-এর বাইরে করা installation-এর জন্য লেখা।
ডেটা ভলিউমটি নীরবে কী পূর্ণ করছে?
Preview এবং প্রতি-ব্যবহারকারীর history ফাইলগুলোর একই ভলিউমে থাকে। Web interface-এ ব্যবহারকারী যে storage figure দেখেন, সেখানে এগুলোর কোনোটিই অন্তর্ভুক্ত হয় না।
- Preview হলো তৈরি করা thumbnail। এগুলো data directory-এর ভেতরের app data folder-এ থাকে এবং নামের শুরুতে
appdata_-এর পরে instance id থাকে। - Deleted file trash-এ থেকে যায়।
trashbin_retention_obligation-এর default মানauto। ফলে space available থাকলে deleted file 30 দিনের বেশি সময়ও থাকতে পারে। আবার space প্রয়োজন হলে 30 দিন পূর্ণ হওয়ার আগেই সেগুলো মুছে যেতে পারে। Deleted file ব্যবহারকারীর সাধারণ quota-র হিসাবে ধরা হয় না। তবে trash-এর নিজস্ব limit আছে: default হিসেবে ব্যবহারকারীর অবশিষ্ট quota space-এর সর্বোচ্চ 50%, অথবা quota না থাকা ব্যবহারকারীর ক্ষেত্রে free disk space। Trash এই limit অতিক্রম করলে Nextcloud প্রথমে সবচেয়ে পুরোনো উপযুক্ত item মুছে দেয়।auto-এর অধীনে 30 দিনের কম পুরোনো item-ও এতে অন্তর্ভুক্ত হতে পারে। - পুরোনো version-ও থেকে যায়।
versions_retention_obligation-এর default মানওauto। এটি সময়ের সঙ্গে version কমিয়ে দেয় এবং প্রতিটি time window-এ সর্বশেষ version রেখে দেয়। সর্বোচ্চ retention period configured থাকলে background job সেই সময়সীমার পরের version, অথবা যে file আর নেই তার version, মুছে দেয়। Quota থাকা account-এর ক্ষেত্রে Versions app ব্যবহারকারীর বর্তমানে অব্যবহৃত quota space-এর 50% লক্ষ্য হিসেবে ধরে। Quota না থাকলে এটি সরাসরি filesystem-এর free space ব্যবহার করে। Space খালি করতে হলে এটি প্রথমে সবচেয়ে পুরোনো version মুছে দেয় এবং অন্তত সর্বশেষ 2টি version রেখে দেয়। তাই এই লক্ষ্য কোনো কঠোর ceiling নয়। ব্যবহারকারী হাতে নাম দেওয়া কোনো version automatic expiration থেকে বাদ থাকে। তবে ব্যবহারকারী সেটি manual-ভাবে মুছে দিতে পারেন, এবংocc versions:cleanupঅন্য version-এর সঙ্গে নাম দেওয়া version-ও মুছে দেয়।
কিছু মুছে ফেলার আগে পরিমাণ নির্ধারণ করুন।
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-এর জন্য একটি করে সংখ্যা থাকে। App data-র সংখ্যা বড় হলে তার preview subdirectory পরীক্ষা করুন। App data-তে avatar এবং cached asset-ও থাকে। নিচের cleanup command-গুলো documented। এগুলোর প্রতিটিই ইচ্ছাকৃতভাবে data ধ্বংস করে।
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 মুছে দেয়। ব্যবহারকারীরা ওই file খুললে Nextcloud সেগুলো আবার তৈরি করে। ফলে space ধীরে ধীরে আবার ব্যবহৃত হয় এবং CPU-তে অতিরিক্ত কাজ পড়ে। Volume-টি যদি বড় disk সমস্যার একটি অংশ মাত্র হয়, তাহলে পুরোনো image এবং অচল build cache সাধারণত অন্য অংশ হয়ে থাকে।
হোস্টে কপি করা ফাইল Nextcloud-এ দেখা যাচ্ছে না কেন?
কারণ Nextcloud directory নয়, database-এ থাকা file cache পড়ে। আপনার কপি করা ফাইলটি disk-এ তৈরি হয়েছে, কিন্তু এর সঙ্গে মিলে এমন কোনো 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-এর username অনুযায়ী একটি folder থাকে, এবং তার ভেতরের files-এ web interface-এ user যে ফাইলগুলো দেখেন সেগুলো থাকে। ফাইলগুলো কোথায় গেছে জানা থাকলে একটি path scan করুন। --all প্রতিটি user-এর directory scan করে এবং বড় instance-এ অনেক সময় নিতে পারে। --unscanned শুধু যেসব ফাইল এখনো সম্পূর্ণভাবে scan করা হয়নি হিসেবে চিহ্নিত, সেগুলোতেই কাজ করে। -v processing-এর সময় প্রতিটি ফাইল print করে। এতে command আটকে আছে মনে হচ্ছে, নাকি আপনি তার অগ্রগতি দেখতে পারছেন—এই পার্থক্য বোঝা যায়।
Scan যথেষ্ট কি না, তা ownership-এর ওপর নির্ভর করে। Container user কোনো ফাইলে write করতে না পারলে ফাইলটি index হয়, কিন্তু পরে move করা যায় না। ফলে listing সঠিক দেখালেও web interface থেকে rename বা delete ব্যর্থ হয়।
PUID এবং PGID সেট করার পর রাইট (write) অপারেশন ব্যর্থ হয় কেন?
কারণ কার্নেল নামের পরিবর্তে সংখ্যা তুলনা করে। PUID এবং PGID সেই সংখ্যাসূচক ইউজার আইডি (uid) এবং গ্রুপ আইডি (gid) নির্ধারণ করে, যা দিয়ে কন্টেইনার প্রসেসটি চলে। হোস্টের প্রতিটি ফাইলেরও একটি সংখ্যাসূচক মালিকানা থাকে। যখন এই দুটি সংখ্যা মেলে না, তখন রাইট অপারেশন প্রত্যাখ্যান করা হয়, তা উভয় পাশে নাম যাই দেখা যাক না কেন।
docker exec -it nextcloud id abc
sudo ls -ln /var/lib/docker/volumes/nextcloud_nextcloud_data/_dataid abc কমান্ডটি কন্টেইনার প্রকৃতপক্ষে যে uid এবং gid ব্যবহার করছে তা প্রিন্ট করে, যা আপনার সেট করা PUID এবং PGID। ls -ln কমান্ডটি সংখ্যাসূচক মালিকদের প্রিন্ট করে এবং -n ফ্ল্যাগটি গুরুত্বপূর্ণ: সাধারণ ls -l কমান্ডটি হোস্টের নিজস্ব ইউজার তালিকার মাধ্যমে সেই সংখ্যাগুলোকে অনুবাদ করে এবং এমন একটি নাম দেখায় যার কন্টেইনারের ভেতরে কোনো অর্থ নেই। এই দুটি সংখ্যা তুলনা করুন।
এরপর অনুমান না করে রাইট অপারেশনটি পরীক্ষা করুন।
docker exec -u abc -it nextcloud touch /data/writetestএকটি Permission denied কমান্ড যা /data ফাইলকে নির্দেশ করে, তা নিশ্চিতকরণ হিসেবে কাজ করে। কন্টেইনারের ভেতর থেকে মালিকানা ঠিক করুন, তারপর একই পরীক্ষা পুনরায় চালান।
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-এর ক্ষেত্রে কন্টেইনারের ইউজার আইডিগুলো /etc/subuid-এ থাকা সাবঅর্ডিনেট রেঞ্জের মাধ্যমে ম্যাপ করা হয়, তাই কন্টেইনারের ভেতরের uid 1000 হোস্টের অনেক বড় একটি uid-এর অন্তর্ভুক্ত। হোস্ট-সাইড chown 1000:1000 কমান্ড তখন এমন একজন মালিক সেট করে যা কন্টেইনার ব্যবহার করতে পারে না, ফলে রাইট অপারেশন ব্যর্থ হয়। কন্টেইনারের ভেতরে chown কমান্ডটি চালানো হলে তা একই ম্যাপিংয়ের মধ্য দিয়ে যায় যা Nextcloud প্রসেসটি নিজে ব্যবহার করে, তাই সংখ্যাগুলো গঠনগতভাবেই মিলে যায়। এই কারণেই অন্য কোনো কিছু ডিবাগ করা শুরু করার আগে PUID এবং PGID-কে ডিস্কের মালিকের সাথে মিলতে হবে।
ব্যাকআপ কীভাবে নিলে restore সত্যিই কাজ করবে?
Database এবং folder-গুলো একই সময়ের অবস্থা থেকে নিন। Maintenance mode login বন্ধ রাখে। ফলে 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 command-এ যা নেই: একটি -t flag। TTY line ending পুনর্লিখন করে। এর মধ্য দিয়ে যাওয়া SQL dump এমনভাবে corrupt হয়, যা restore করার সময় না আসা পর্যন্ত ধরা পড়ে না। আরও লক্ষ করুন, command চলার সময় command line-এ থাকা password ps output-এ দেখা যায়। আপনার .env file থেকে password shell-এ পড়লে তা shell history-তে টাইপ করা এড়ানো যায়। কিন্তু expanded command-line argument গোপন থাকে না। পুরোনো database image-এ mariadb-dump-এর পরিবর্তে mysqldump থাকে। Manual-এ দুটিই নথিভুক্ত আছে।
Restore করতে dump একটি খালি database-এ load করুন। উভয় archive fresh volume-এ unpack করুন। Container-গুলো start করুন। এরপর maintenance mode বন্ধ করুন। Folder এবং dump ভিন্ন সময়ের হলে file cache এবং disk-এর তথ্যের মধ্যে অমিল হয়। occ files:scan --all শুধু একটি দিক মেরামত করতে পারে। এটি এমন file খুঁজে পায়, যার কোনো row নেই। কোনো row যে file নির্দেশ করে, file-টি অনুপস্থিত হলে এটি তা ফিরিয়ে আনতে পারে না।
ফলাফলটি server-এর বাইরে রাখুন। একই VPS-এর ভেতরে থাকা copy VPS-এর সঙ্গেই নষ্ট হয়ে যায়। তাই off-server repository-তে restic ব্যবহার এই প্রক্রিয়ার অংশ হওয়া উচিত। একই কারণে provider snapshot backup থেকে আলাদা tool। আপনি যদি এখনও stack তৈরি করেন, VPS-এ সম্পূর্ণ Nextcloud install এই guide-এ বাদ থাকা reverse proxy এবং TLS (transport layer security) certificate-এর বিষয়টি ব্যাখ্যা করে।
FAQ
Nextcloud-এর data directory Docker container-এ কোথায়?
linuxserver.io image ব্যবহার করলে এটি container-এর ভিতরে /data-এ থাকে, এবং /config-এর অধীনে config.php, apps ও themes থাকে। এগুলো container path। host path জানতে docker inspect nextcloud চালিয়ে Mounts section-এ Source value দেখুন, অথবা volume-এর ওপর docker volume inspect চালিয়ে Mountpoint পড়ুন। অন্য Nextcloud image ভিন্ন container path ব্যবহার করে। তাই আপনি যে tag pin করেছেন, তার documentation দেখুন এবং docker exec -it nextcloud occ config:system:get datadirectory দিয়ে নিশ্চিত করুন।
আমি volume-এ copy করা file Nextcloud-এ দেখতে পাচ্ছি না কেন?
Nextcloud directory পড়ার পরিবর্তে database-এর file cache থেকে row তালিকাভুক্ত করে। তাই Nextcloud-এর মধ্য দিয়ে না আসা file-এর কোনো row থাকে না এবং সেটি অদৃশ্য থাকে। একটি folder-এর জন্য docker exec -it nextcloud occ files:scan --path="/alice/files/Photos" চালান, অথবা সব user-এর জন্য occ files:scan --all চালান। File দেখা গেলেও যদি পরে move বা delete করা না যায়, কারণটি ownership। Container user-এর file-গুলোতে write করার অনুমতি থাকতে হবে।
Nextcloud restore করার জন্য data volume-এর একটি copy কি যথেষ্ট?
না। Data volume-এ file content থাকে। Database-এ file index-এর পাশাপাশি users ও shares থাকে, আর config.php-এ database credentials ও instance id থাকে। সঠিকভাবে restore করতে data folder, config folder, database এবং আপনি ব্যবহার করলে custom apps ও theme folder—সব প্রয়োজন। এগুলো একই সময়ের অবস্থান থেকে নিন। কারণ file-এর চেয়ে নতুন database এমন file-এর দিকে নির্দেশ করতে পারে, যা আর নেই।
আমার data volume users যে file দেখতে পায় তার চেয়ে অনেক বড় কেন?
একই volume-এ previews, deleted files এবং old versions থাকে। এগুলোর কোনোটি user যে figure দেখে তাতে দেখা যায় না। docker exec -it nextcloud sh -c 'du -sh /data/*' দিয়ে মাপুন। ডিফল্টভাবে প্রয়োজন হলে trash can 30 দিনের আগের file delete করে এবং স্থান খালি থাকলে সেগুলো আরও বেশি সময় ধরে রাখে। Quota থাকা account-এর ক্ষেত্রে version cleanup অবশিষ্ট quota space-এর অর্ধেক লক্ষ্য করে। অন্যথায় এটি সরাসরি filesystem-এর free space ব্যবহার করে। তবে সাম্প্রতিক version সংরক্ষণ করা হলে লক্ষ্য পূরণ নাও হতে পারে। occ trashbin:cleanup --all-users, occ versions:cleanup alice এবং occ preview:cleanup দিয়ে এগুলো পরিষ্কার করুন। Users তাদের file খুললে previews আবার বাড়বে।
Nextcloud-এর data directory কি অন্য disk-এ সরানো যাবে?
Nextcloud যে path জানে সেটি পরিবর্তন না করে নতুন location-টি একই container path-এ mount করুন। Container বন্ধ করুন। Ownership সংরক্ষণ করে পুরনো content নতুন disk-এ copy করুন (cp -a বা rsync -aAX)। এরপর compose file-এ volume বা bind mount-কে নতুন location-এর দিকে নির্দেশ করুন এবং container আবার চালু করুন। Nextcloud এখনও /data দেখতে পাবে। তাই database-এর কোনো row পরিবর্তন করতে হবে না। docker exec -it nextcloud occ config:system:get datadirectory এবং একটি test upload দিয়ে যাচাই করুন।