SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor · আপডেট করা হয়েছে 2026-11-10

Docker Compose cheat sheet: সার্ভারে দৈনন্দিন কমান্ড

বাস্তব সার্ভারে প্রতিদিনের কাজে দরকারি Compose কমান্ড একসঙ্গে পান: lifecycle, পরিবর্তন প্রয়োগ, logs, shell, network, volume ও নিরাপদ cleanup।

আপনি বাস্তবে যে Compose কমান্ডগুলো বেশি ব্যবহার করবেন

Docker Compose-এ কয়েক ডজন subcommand রয়েছে। সার্ভারে দৈনন্দিন কাজে এর মধ্যে প্রায় এক ডজন কমান্ডই ব্যবহৃত হয়। আপনি যে কাজটি করছেন, তার ভিত্তিতে এই পৃষ্ঠায় সেগুলো সাজানো হয়েছে। প্রতিটি কমান্ডের জন্য একটি সরল কারণ দেওয়া হয়েছে। কোনো কমান্ডের মধ্যে লুকানো জটিলতা থাকলে বিস্তারিত ব্যাখ্যার দিকে নির্দেশ করা হয়েছে।

এখানে সব উদাহরণ Compose V2 বা V5 ব্যবহার করে: docker compose-এর মধ্যে একটি space থাকে, পুরোনো docker-compose script নয়। দুটিই Go plugin। Linux-এ Compose plugin Docker Engine থেকে আলাদাভাবে install করতে হয়। Ubuntu 24.04 LTS-এর universe repository-তে এখনও legacy Python V1 tool, docker-compose version 1.29.2-6ubuntu1 হিসেবে পাওয়া যায়। docker compose version দিয়ে যাচাই করুন। কমান্ডটি unavailable হলে Docker-এর repository সেট up করে docker-compose-plugin package install করুন।

নিচের প্রতিটি কমান্ড সেই directory থেকে চালাতে হবে যেখানে আপনার compose.yaml রয়েছে। আপনি project name override না করলে Compose ওই directory-এর নামকে default project name হিসেবে ব্যবহার করে। -f বা COMPOSE_FILE না থাকলে Compose working directory এবং তার parent directory-গুলোতে configuration file খোঁজে। তাই এক level উপরে থেকে চালালে আপনার stack কেবল তখনই পাওয়া যাবে, যখন তার file ওই search path-এর মধ্যে থাকবে। File format আপনার কাছে নতুন হলে VPS-এ প্রথম Compose file দিয়ে শুরু করুন। এরপর কমান্ডগুলোর জন্য এখানে ফিরে আসুন।

Lifecycle: আপনি যে চারটি কমান্ড লেখেন, এবং যে কমান্ডটি container সরিয়ে দেয়

docker compose up -d
docker compose up -d --wait
docker compose stop
docker compose start
docker compose restart web
docker compose down

up -d network তৈরি করে, container তৈরি করে, সেগুলো চালু করে এবং ফিরে আসে। এটি application ready হওয়ার জন্য অপেক্ষা না করে container চালু করার পরই ফিরে আসে। তাই এর পরে curl probe চালানো deploy script প্রথমবার প্রায়ই ব্যর্থ হয়। up -d --wait healthcheck থাকা service-গুলো healthy হওয়া পর্যন্ত এবং healthcheck না থাকা service-গুলো running হওয়া পর্যন্ত অপেক্ষা করে। কোনো service unhealthy হলে বা --wait-timeout শেষ হয়ে গেলে এটি non-zero exit দেয়। এই flag-এর কার্যকারিতা এর পেছনের check-এর মানের ওপর নির্ভর করে। তাই automation-এ এটি ব্যবহার করার আগে Compose বিশ্বাস করতে পারে এমন একটি healthcheck লিখুন।

stop container থামায় কিন্তু সেগুলো রেখে দেয়। তাই start একই writable layer-সহ একই container আবার চালু করে। down container থামানোর পর সেগুলো এবং project network সরিয়ে দেয়। volume-এর বাইরে container-এর ভেতরে লেখা যেকোনো data container-এর সঙ্গে সরিয়ে যায়। Compose-এ এটিই সবচেয়ে ব্যয়বহুল ভুল-বোঝাবুঝি। down এবং stop-এর সম্পূর্ণ পার্থক্য কোন পরিস্থিতিতে এর প্রভাব পড়ে তা ব্যাখ্যা করে।

restart reload নয়। এটি একই container থামিয়ে আবার চালু করে এবং container-এর বিদ্যমান configuration ব্যবহার করে। তাই পরিবর্তিত environment variable, নতুন image tag বা সম্পাদিত port mapping-এর কোনো প্রভাব পড়ে না। file পরিবর্তন প্রয়োগ করতে আবার up -d চালান। Compose প্রতিটি service-কে তার চলমান container-এর সঙ্গে তুলনা করে। configuration বা image পরিবর্তিত হলে সংশ্লিষ্ট container পুনরায় তৈরি করে।

পরিবর্তন প্রয়োগ: recreate, pull, নাকি rebuild

docker compose up -d --force-recreate
docker compose pull && docker compose up -d
docker compose build --no-cache web
docker compose up -d --build web

up -d চলমান container পুনঃব্যবহার করে, যদি তাদের configuration এবং image অপরিবর্তিত থাকে; image pull এবং build service-এর pull policy অনুসরণ করে। --force-recreate এই তুলনা উপেক্ষা করে এবং configuration অভিন্ন হলেও প্রতিটি container প্রতিস্থাপন করে। তাই container-এর অস্বাভাবিক অভ্যন্তরীণ state পরিষ্কার করার এটি সবচেয়ে দ্রুত উপায়।

স্পষ্ট image update routine-এ দুটি command ব্যবহার করা হয়, কারণ এগুলো দুটি ভিন্ন কাজ করে। pull file-এ উল্লেখ করা প্রতিটি tag-এর বর্তমান image download করে। এরপর up -d দেখে যে service-এর image ID তার চলমান container-এর সঙ্গে আর মেলে না, এবং container-টি recreate করে। Default missing pull policy-তে cache করা tag পুনঃব্যবহার করা হয়, শুধু latest-এর ক্ষেত্রে প্রতিবার pull করা হয়। বিপরীত ঝুঁকি দেখা দেয় multi-service stack-এ। সেখানে একসঙ্গে প্রতিটি service-এর জন্য latest pull করলে দশ সেকেন্ড আগেও চলমান একটি app নষ্ট হয়ে যেতে পারে। তাই self-hosted AFFiNE workspace application এবং migration image একই digest-এ pin করার পরামর্শ দেয়। Pinning করলে upgrade একটি নির্দিষ্ট পরিবর্তনে পরিণত হয়: tag ইচ্ছাকৃতভাবে সম্পাদনা করার পর একই pull এবং recreate চালাতে হয়। যে stack boot হওয়ার সময় database migration করে, সেখানে যেকোনো command চালানোর আগে একটি dump হাতে রাখা উচিত। প্রতিটি version bump-এর সময় self-hosted Chatwoot support desk এই routine অনুসরণ করে।

build সেই service-এর ক্ষেত্রে প্রযোজ্য, যেগুলোতে build: section ঘোষণা করা থাকে। যেসব service-এ image:-ও ঘোষণা করা থাকে, সেগুলোর ক্ষেত্রেও এটি প্রযোজ্য। up -d --build এক ধাপেই build এবং start করে। Code পরিবর্তনের সময় এটিই স্বাভাবিক কাজের ধারা। Cached layer স্পষ্টভাবে পুরোনো না হলে --no-cache ব্যবহার করবেন না, কারণ এটি প্রতিটি layer শূন্য থেকে rebuild করে। কিছু project একই cloned repo থেকে দুটি পথ সরবরাহ করে। তখন এই দুটি loop বিকল্প update path হিসেবে কাজ করে। self-hosted openGym workout tracker তার pinned checkout build করতে docker compose up -d --build ব্যবহার করে, কারণ এর latest image pull করলে সেই checkout-এর চেয়ে নতুন release চালু হতে পারে।

চলমান কী আছে তা দেখা

docker compose ps
docker compose ps -a
docker compose logs -f --tail=100
docker compose logs --since 15m --timestamps db
docker compose top
docker compose ls

ps শুধু চলমান container তালিকাভুক্ত করে। কোনো service start হওয়ার সময় crash করলে -a যোগ না করা পর্যন্ত এখানে সেটি দেখা যাবে না। তাই ps-এ কোনো container না থাকলেও ps -a সেটিকে Exited (1) হিসেবে দেখানো startup failure-এর স্বাভাবিক চিত্র। প্রথমে exit code দেখুন। এরপর logs দেখুন।

logs -f একসঙ্গে প্রতিটি service অনুসরণ করে এবং প্রতিটি লাইনের শুরুতে service-এর নাম যোগ করে। service-গুলো একে অপরের সঙ্গে যোগাযোগ করলে এবং event-এর ক্রম গুরুত্বপূর্ণ হলে এটিই প্রয়োজনীয় view। নির্দিষ্ট service-এর নাম দিলে ফলাফল সীমিত করা যায়। এক মাস ধরে চলমান কোনো container-এর ক্ষেত্রে --tail=100 গুরুত্বপূর্ণ, কারণ default হিসেবে সম্পূর্ণ history দেখানো হয় এবং terminal ভরে যায়। আপনি সাধারণত যে প্রশ্নের উত্তর চান, --since 15m সেটিই দেয়: আপনি যে restart করেছেন, তার সময় কী ঘটেছিল।

top প্রতিটি container-এর ভেতরের process তালিকাভুক্ত করে। এতে “container চলছে” এবং “এর ভেতরের process চলছে”—এই দুটি বিষয় আলাদা করে যাচাই করা যায়। ls বর্তমান directory-এর বাইরে গিয়ে host-এ চলমান Compose project-গুলোর status সহ তালিকা দেখায়। বন্ধ project-গুলোও অন্তর্ভুক্ত করতে -a যোগ করুন।

একটি service-এর ভিতরে shell চালানো

docker compose exec web sh
docker compose exec -u root web sh
docker compose run --rm web env
docker compose run --rm --no-deps web sh

exec বর্তমানে চালু থাকা container-এর ভিতরে একটি command চালায়। run একই service definition থেকে একটি নতুন container চালু করে। service যথেষ্ট সময় চালু না থাকলে exec করার জন্য এটিই প্রয়োজন। সব সময় run-এর সঙ্গে --rm ব্যবহার করুন। এটি না দিলে প্রতিটি invocation-এর পরে একটি stopped container থেকে যায়। এগুলো জমতে জমতে docker compose ps -a পড়া কঠিন হয়ে যায়।

bash ব্যবহার করার আগে sh চেষ্টা করুন। কিছু Alpine ভিত্তিক image-এ bash থাকে। Official PostgreSQL Alpine image-ও এর অন্তর্ভুক্ত। এটি না থাকলে error হিসেবে exec: "bash": executable file not found in $PATH দেখা যায়। run-এ --no-deps যোগ করলে service-এর dependencies বাদ দেওয়া হয়। ফলে দ্রুত configuration check করার সময় পুরো database চালু হয় না।

প্রতিটি .env file, environment: block এবং shell variable merge হওয়ার পরে service বাস্তবে কোন environment পেয়েছে, তা দেখার দ্রুততম উপায় হলো run --rm web env। কোনো value ভুল হলে সাধারণত merge order-ই এর কারণ। Compose কীভাবে env file ও secret resolve করে কোন source-এর অগ্রাধিকার থাকে তা ব্যাখ্যা করে।

নেটওয়ার্ক, পোর্ট এবং নাম রেজোলিউশন

docker compose port web 80
docker compose exec web getent hosts db
docker compose config --networks

ডিফল্টভাবে, Compose প্রতিটি service-কে একটি project network-এ রাখে এবং প্রতিটি service-এর নাম সেই network-এ একটি DNS name হিসেবে কাজ করে। image-এ getent থাকলে, web-এর ভেতরে getent hosts db চালিয়ে নাম রেজোলিউশন পরীক্ষা করা যায়; এতে db connection গ্রহণ করছে কি না পরীক্ষা হয় না। নাম resolve হলেও connection refused হলে, server চলছে কি না এবং অনুরোধ করা address ও port-এ listening করছে কি না পরীক্ষা করুন; শুধু 127.0.0.1-এ bind করা এর একটি সম্ভাব্য কারণ। একই সীমার কারণে project-এর বাইরে শুরু করা কোনো container, docker run দিয়ে শুরু করা হোক বা নিজস্ব stack হিসেবে চলুক, jellyfin-এর মতো service name resolve করতে একটি shared network প্রয়োজন। আপনার Jellyfin library-এর জন্য Halcyon front end যে server-এ নির্দেশ করে সেখানে পৌঁছাতে না পারলে এটিই প্রথমে পরীক্ষা করুন। এই মডেলের বাকি অংশ Compose network এবং service DNS কীভাবে কাজ করে-এ ব্যাখ্যা করা হয়েছে।

port web 80 একটি container port কোন host address ও port-এ publish করা হয়েছে তা দেখায়। Mapping কোনো variable থেকে এলে এতে অনুমান করতে হয় না। কোনো port publish করলে Docker নিজে পরিচালনা করা একটি firewall rule-ও তৈরি করে। এই rule আপনার rule-এর আগে কার্যকর হয়। তাই আপনি কোনো service-কে private মনে করলেও সেটি internet-এ open থাকতে পারে। এই পরিস্থিতি কেন published Docker port ufw-এর নিয়ম এড়িয়ে যায়-এ ব্যাখ্যা করা হয়েছে। ওই port-গুলো unpublished রেখে project network-এ service-গুলোর সামনে authentication করা একটি proxy বসানো বেশি নিরাপদ। Authentik-কে single sign-on layer হিসেবে চালানো এই কাঠামোই দেয়।

ভলিউম ও ডেটা

docker compose config --volumes
docker compose cp db:/etc/postgresql/pg_hba.conf ./pg_hba.conf
docker compose down -v

config --volumes প্রকল্পে ঘোষিত named volume-গুলো প্রতি লাইনে একটি করে দেখায়। এই তালিকা backup inventory-এর একটি অংশ মাত্র। bind mount এবং configuration file-ও পরীক্ষা করতে হবে। কোনো volume-এ পুনরায় তৈরি করা অসম্ভব ডেটা থাকলে সঠিক backup command তালিকার মতোই গুরুত্বপূর্ণ। এ কারণেই PhotoPrism ও Immich-এর তুলনা প্রতিটি photo server-এর প্রয়োজনীয় dump এবং copy command স্পষ্টভাবে দেখায়। shell না খুলেই container-এর ভিতরে বা বাইরে file copy করতে cp ব্যবহার করা হয়। container যে পাশে থাকবে, সেই পাশে service:path form ব্যবহার করতে হবে।

down -v external volume ছাড়া ঘোষিত named volume-গুলো সরিয়ে দেয়। একই সঙ্গে container-এর সঙ্গে সংযুক্ত anonymous volume এবং container-গুলোও সরিয়ে দেয়। test stack সম্পূর্ণভাবে সরানোর জন্য এটি উপযুক্ত command। তবে গুরুত্বপূর্ণ ডেটা থাকা stack-এর জন্য এটি ব্যবহার করা উচিত নয়, কারণ কোনো confirmation নেই এবং undo করার উপায়ও নেই। bind mount এতে টিকে থাকে, কারণ সেগুলো host filesystem-এ থাকে। blast radius-এর এই পার্থক্য bind mount ও named volume-এর মধ্যে ইচ্ছাকৃতভাবে বেছে নেওয়ার একটি কারণ।

ডেটা না হারিয়ে ডিস্ক খালি করার পরিচ্ছন্নতা

docker compose down --remove-orphans
docker system df
docker image prune -a
docker builder prune

--remove-orphans প্রকল্পের অন্তর্ভুক্ত, কিন্তু ফাইলে আর নেই—এমন container মুছে দেয়। কোনো service-এর নাম পরিবর্তন করার পরে সাধারণত এ ধরনের container তৈরি হয়। এটি ব্যবহার না করলে ওই container-গুলো চলতেই থাকে। docker compose ps ডিফল্টভাবে চলমান orphan container-ও অন্তর্ভুক্ত করে।

কিছু মুছে ফেলার আগে ডিস্কের জায়গা কোথায় ব্যবহৃত হয়েছে তা docker system df দেখায়। এটি image, container, local volume এবং build cache আলাদা করে দেখায় এবং প্রতিটির reclaimable পরিমাণও জানায়। কোনো container ব্যবহার করছে না—এমন সব image, tag থাকুক বা না থাকুক, image prune -a মুছে দেয়। বড় image-এর একাধিক version pull করা থাকলে এটি সাধারণত সবচেয়ে বেশি জায়গা খালি করে। builder prune ডিফল্টভাবে dangling build cache মুছে দেয়। সব unused build cache মুছতে -a যোগ করুন।

এগুলোর কোনোটিই named volume-এ প্রভাব ফেলে না। docker volume prune --all, docker compose down -v এবং docker volume rm named volume মুছে দেয়। সাধারণ docker volume prune শুধু anonymous volume মুছে দেয়।

কোনো সমস্যা তৈরি করার আগে ফাইল পরীক্ষা করা

docker compose config --quiet
docker compose config --services
docker compose --dry-run up -d

config --quiet সফল হলে কোনো আউটপুট দেয় না, তাই এটি deploy-এর আগে কোনো ধাপে বা git hook-এ রাখা উপযুক্ত। সাধারণ config সম্পূর্ণ merge ও interpolate করা ফাইলটি দেখায়। এভাবেই নিশ্চিত করা যায় যে কোনো variable-এর মান সঠিকভাবে নির্ধারিত হয়েছে এবং override file প্রত্যাশামতো স্তরবিন্যাস হয়েছে। unset variable সেখানে খালি মান হিসেবে দেখা যায়, এবং পাশে The "X" variable is not set. Defaulting to a blank string. সতর্কবার্তা থাকে।

--dry-run একটি global flag, subcommand flag নয়। তাই এটি up-এর আগে দিতে হয়। এটি Compose যে প্রতিটি action নিত, তা দেখায় কিন্তু কোনো পরিবর্তন করে না। গুরুত্বপূর্ণ stack-এ down চালানোর আগে এই ত্রিশ সেকেন্ড ব্যয় করা যুক্তিসঙ্গত।

ফাইল, প্রোফাইল এবং প্রজেক্ট নিয়ে কাজ করা

docker compose -f compose.yaml -f compose.prod.yaml up -d
docker compose --profile debug up -d
docker compose -p staging up -d

একাধিক -f flag ক্রমানুসারে একত্র করা হয়। পরের ফাইলগুলো key অনুযায়ী আগের ফাইলের মান প্রতিস্থাপন করে। একটি base file-এর সঙ্গে ছোট production override রাখার এটিই প্রচলিত পদ্ধতি। তবে list এবং map-এর ক্ষেত্রে নিয়ম আলাদা। তাই অপ্রত্যাশিত ফলাফল debug করার আগে Compose কীভাবে একাধিক file merge করে পড়ুন।

--profile profile-এ চিহ্নিত service-গুলোকে profile ছাড়া service-গুলোর পাশাপাশি চালু করে। এতে সাধারণ up-এর বাইরে debug tooling রাখা যায়। -p project name নির্ধারণ করে। ফলে একই stack-এর দুটি কপি আলাদা network এবং আলাদা volume name ব্যবহার করে পাশাপাশি চালানো যায়। reboot-এর পরে stack পুনরায় চালু করতে restart policy ব্যবহার করা যায়, অথবা এমন একটি unit ব্যবহার করা যায় যা আপনার হয়ে Compose চালায়। এটি boot-এর সময় Compose stack চালু করা-তে বর্ণনা করা হয়েছে।

FAQ

হাইফেনসহ docker-compose-এর বদলে কী এসেছে?

Compose V2 এবং V5 এসেছে, যেগুলো docker compose হিসেবে একটি space দিয়ে চালানো হয়। Linux-এ Compose একটি আলাদাভাবে ইনস্টল করা plugin; Ubuntu 24.04 LTS এখনও তার universe repository-তে V1 Python tool দেয়। space-সহ form উপলভ্য না থাকলে Docker-এর repository সেট আপ করে docker-compose-plugin package ইনস্টল করুন। পুরোনো script-গুলোতে alias যোগ না করে space-সহ form ব্যবহার করুন, কারণ V2-তে V1-এ না থাকা flag আছে।

docker compose restart কেন আমার configuration পরিবর্তন গ্রহণ করছে না?

restart বিদ্যমান container-কে যে configuration দিয়ে তৈরি করা হয়েছিল, সেটি ব্যবহার করে stop ও start করে; এটি কখনও compose.yaml নতুন করে পড়ে না। environment variable, port, volume বা image tag পরিবর্তন করলে docker compose up -d প্রয়োজন হয়। এটি প্রতিটি service-কে তার চলমান container-এর সঙ্গে তুলনা করে এবং যেগুলোর পার্থক্য আছে সেগুলো পুনরায় তৈরি করে। file-এ কোনো পরিবর্তন না থাকলেও replacement করাতে চাইলে --force-recreate যোগ করুন।

কীভাবে কোনো service-কে নতুন image-এ update করব?

docker compose pull চালান, তারপর docker compose up -d চালান। pull command file-এ থাকা প্রতিটি tag-এর বর্তমান image আনে, এবং up -d এমন যেকোনো service পুনরায় তৈরি করে যার image ID তার container-এর সঙ্গে মেলে না। একা up -d চালালে pull policy অনুসরণ করা হয়। ডিফল্ট missing policy cached image পুনরায় ব্যবহার করে, তবে latest সবসময় pull করা হয়।

চলমান server-এ কোন cleanup command নিরাপদ?

docker system df কোনো কিছু মুছে না ফেলে disk usage দেখায়; docker image prune -a এবং docker builder prune অব্যবহৃত image ও build cache সরায়। তাই চলমান service কাজ করতে থাকে এবং named volume অপরিবর্তিত থাকে। ঝুঁকিপূর্ণ জোড়াটি হলো docker compose down -v। এটি কোনো prompt ছাড়াই project-এ ঘোষিত non-external named volume এবং সংযুক্ত anonymous volume মুছে দেয়। docker volume prune --all অব্যবহৃত local volume মুছে দেয়, যার মধ্যে named volume-ও আছে। এটি একবার y/N prompt দেখায়, অথবা -f ব্যবহার করলে কোনো prompt দেখায় না। ঝুঁকিতে কী আছে তা জানতে আগে docker compose config --volumes চালান।

পুরো stack চালু না করে কি একটি command চালাতে পারি?

হ্যাঁ। docker compose run --rm --no-deps web sh web service definition থেকে একটি container চালু করে, তার dependency এড়িয়ে যায় এবং আপনি বের হলে container-টি মুছে দেয়। container ইতিমধ্যে চলমান থাকলে exec ব্যবহার করুন। কারণ exec চলমান container-এর ভেতরে আপনার command চালায় এবং service-এর প্রকৃত বর্তমান অবস্থা দেখায়।

এই লেখাটি কি কাজে লেগেছে?