SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor

Docker Compose দিয়ে Planka সেলফ-হোস্ট করার নিয়ম

Docker Compose ব্যবহার করে কীভাবে Planka ডেপ্লয় করবেন তা জানুন। Postgres কনফিগারেশন, Traefik সেটআপ এবং BASE_URL ভেরিয়েবলটি সঠিকভাবে সেট করার উপায় দেখুন যা লগইন সমস্যা সমাধান করে।

Planka self-hosting করে আপনি যা পাবেন

Planka self-hosting করলে আপনার টিম Trello থেকে পরিচিত কার্ড, লিস্ট এবং লেবেল মডেলের একটি Kanban বোর্ড পায়, যা আপনার নিয়ন্ত্রণাধীন একটি VPS-এ চলে। এতে কোনো সিট লিমিট বা প্রতি ব্যবহারকারীর জন্য বিলিং নেই, কারণ একমাত্র খরচ হলো সার্ভারের খরচ। এই নির্দেশিকাটি Traefik-এর পেছনে Docker Compose ব্যবহার করে এটি ডেপ্লয় করে, যেখানে ডেটার জন্য Postgres এবং ব্যবহারকারীদের আপলোড করা প্রতিটি ফাইলের জন্য একটি named volume ব্যবহৃত হয়।

Planka 2 প্রজেক্টটির নিজস্ব Fair Use License-এর অধীনে রিলিজ হয়, যা প্রজেক্টটি ওপেন সোর্স না বলে সোর্স-অ্যাভেইলেবল হিসেবে বর্ণনা করে। আপনার নিজের প্রতিষ্ঠানের অভ্যন্তরীণ প্রজেক্টের জন্য এটি চালানো অনুমোদিত। তৃতীয় পক্ষকে বাণিজ্যিক হোস্টেড সার্ভিস হিসেবে এটি অফার করতে হলে Pro বা Enterprise লাইসেন্স প্রয়োজন।

আমি এমন একটি টিমের কথা মাথায় রেখেছি যারা দুই থেকে পাঁচ সদস্যের এবং Trello-এর ফ্রি টায়ার থেকে সরে আসছে। আপনি যদি এখনো সিদ্ধান্ত না নিয়ে থাকেন যে কোন বোর্ডটি ব্যবহার করবেন, তবে প্রথমে self-hosted Trello বিকল্পগুলোর তুলনা পড়ুন। এই নির্দেশিকাটি ধরে নেয় যে আপনি সিদ্ধান্ত নিয়ে ফেলেছেন এবং এটি শুধুমাত্র ডেপ্লয়মেন্টের ওপর আলোকপাত করে।

আপনার প্রয়োজন Docker Engine এবং Compose প্লাগইনসহ একটি VPS, এবং সেটির দিকে নির্দেশ করা একটি DNS A record। আপনার সেই বক্সে TLS (transport layer security) টার্মিনেট করছে এমন একটি Traefik ইনস্ট্যান্সও প্রয়োজন। যদি Traefik এখনো সেটআপ করা না থাকে, তবে প্রথমে একাধিক Compose অ্যাপের সামনে একটি Traefik reverse proxy সেটআপ করুন, এবং নিচের ফাইলটি অপরিচিত মনে হলে VPS-এর জন্য Docker Compose-এর মৌলিক বিষয়গুলো পড়ুন।

Planka-এর জন্য কতটা VPS প্রয়োজন?

প্রকল্পের technical FAQ ছোট দলের জন্য অন্তত 2 GB RAM এবং 10 GB storage সুপারিশ করে। তাই এই সংখ্যাগুলোকে চূড়ান্ত পরিমাপ নয়, বরং প্রাথমিক নির্দেশনা হিসেবে ধরুন।

বাস্তবে চালু থাকা উপাদানগুলো ছোট: API এবং build করা frontend পরিবেশন করার জন্য একটি Node.js process, এবং data সংরক্ষণের জন্য একটি Postgres server। Postgres একটি supervising process-এর পাশাপাশি প্রতিটি খোলা connection-এর জন্য একটি backend process চালায়। Planka container-এর ভেতরে একটি ছোট proxy process-ও চলে, যা এর outgoing request filter করে। 2 GB plan ছোট দলের জন্য প্রকল্পটির RAM recommendation-এর সঙ্গে সামঞ্জস্যপূর্ণ। একটি board-এর resource usage কম। তাই একই VPS-এ যদি আপনার দলের documents-ও রাখতে চান, আগে সেই app-এর প্রয়োজন অনুযায়ী VPS-এর আকার নির্ধারণ করুন: Notion-এর মতো workspace হিসেবে AFFiNE চালানো-এর জন্য Planka কিছু চাওয়ার আগেই নিজস্বভাবে কয়েক gigabyte প্রয়োজন হতে পারে।

Memory নির্ধারণের আগে disk-এর আকার নির্ধারণ করুন, কারণ attachment-ই সবচেয়ে বেশি বাড়ে। এই paragraph-এর ওপর নির্ভর না করে নিজের instance মাপুন:

docker stats --no-stream
docker system df -v

প্রথম command-টি প্রতিটি container-এর বর্তমান memory ও CPU usage দেখায়। দ্বিতীয়টি প্রতিটি volume-এ কতটা space আছে তা দেখায়। সাধারণভাবে এক সপ্তাহ কাজ করার পর উভয় reading নিন, install করার দিন নয়। কারণ নিষ্ক্রিয় board আপনার দলের ব্যবহার সম্পর্কে কিছুই জানায় না।

Compose ফাইল লিখুন

ডিরেক্টরি তৈরি করে এর ownership নিন, যাতে sudo-এর মাধ্যমে আপনাকে কখনও এই ফাইলগুলো সম্পাদনা করতে না হয়।

sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/planka

Compose ফাইলের পাশে একটি .env ফাইলে secrets তৈরি করুন। Compose এই ফাইলটি স্বয়ংক্রিয়ভাবে পড়ে এবং এর মানগুলো প্রতিস্থাপন করে।

umask 077
{
  printf 'SECRET_KEY=%s\n' "$(openssl rand -hex 64)"
  printf 'POSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 24)"
  printf 'ADMIN_PASSWORD=%s\n' "$(openssl rand -hex 12)"
} > .env
chmod 600 .env

openssl rand -hex ব্যবহার করার কারণ আছে। একটি hex string-এ শুধু digit এবং a থেকে f পর্যন্ত অক্ষর থাকে। তাই এটি যে DATABASE_URL connection string-এ বসানো হয়, সেটি নষ্ট করতে পারে না। Standard Base64-এ slash, plus sign এবং padding equals sign থাকতে পারে, কিন্তু at sign থাকে না; connection URL-এ বিশেষ অর্থ বহনকারী অক্ষরগুলোর percent-encoding প্রয়োজন। বৃহত্তর বিষয়টি Compose ফাইলের বাইরে secrets রাখা-এ ব্যাখ্যা করা হয়েছে।

এখন docker-compose.yml করুন। উভয় স্থানে kanban.example.com-এর বদলে আপনার নিজের hostname বসান।

services:
  planka:
    image: ghcr.io/plankanban/planka:2.2.1
    restart: unless-stopped
    volumes:
      - planka-data:/app/data
    environment:
      - BASE_URL=https://kanban.example.com
      - DATABASE_URL=postgresql://planka:${POSTGRES_PASSWORD}@postgres/planka
      - SECRET_KEY=${SECRET_KEY}
      - TRUST_PROXY=true
      - DEFAULT_ADMIN_EMAIL=you@example.com
      - DEFAULT_ADMIN_PASSWORD=${ADMIN_PASSWORD}
      - DEFAULT_ADMIN_NAME=Your Name
      - DEFAULT_ADMIN_USERNAME=admin
    networks:
      - proxy
      - internal
    labels:
      - "traefik.enable=true"
      - "traefik.docker.network=proxy"
      - "traefik.http.routers.planka.rule=Host(`kanban.example.com`)"
      - "traefik.http.routers.planka.entrypoints=websecure"
      - "traefik.http.routers.planka.tls.certresolver=default"
      - "traefik.http.services.planka.loadbalancer.server.port=1337"
    depends_on:
      postgres:
        condition: service_healthy

  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    volumes:
      - db-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=planka
      - POSTGRES_USER=planka
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
    networks:
      - internal
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U planka -d planka"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  planka-data:
  db-data:

networks:
  proxy:
    external: true
  internal:

ওই ফাইলের চারটি সিদ্ধান্ত ব্যাখ্যা করা দরকার। কারণ এগুলো পরিবর্তন করে পরে অনেকেই সমস্যায় পড়েন।

  • Planka service-এ কোনো ports: block নেই। Traefik proxy network-এর মাধ্যমে container-এ পৌঁছায়। তাই host-এ port 1337 publish করা হয় না। এটি publish করলে যে কেউ আপনার proxy এবং certificate এড়িয়ে সরাসরি service-এ পৌঁছাতে পারত।
  • loadbalancer.server.port=1337 container-এর ভেতরের port নির্ধারণ করে। Planka 1337 port-এ listen করে। Upstream example শুধু 3000 port-এ পৌঁছায়, কারণ সেটি port-টি host-এ map করে। এখানে কোনো host mapping নেই। তাই Traefik-কে container port জানাতে হয়।
  • condition: service_healthy Postgres healthcheck-এর সঙ্গে কাজ করে। এটি না থাকলে database connection গ্রহণের আগে Planka start হয়। প্রথম query ব্যর্থ হয়ে process exit করে, যা crash loop-এর মতো দেখায়। প্রক্রিয়াটি Compose healthcheck এবং startup ordering-এ ব্যাখ্যা করা হয়েছে।
  • Database service-এর নাম ইচ্ছাকৃতভাবে postgres রাখা হয়েছে। Planka 2 নিজস্ব outgoing request একটি internal filter-এর মাধ্যমে পাঠায়, যার default block list হলো localhost,postgres। Service-এর নাম পরিবর্তন করলে ওই তালিকা থেকে আপনার database নীরবে বাদ পড়বে।

কোনো কিছু start করার আগে Compose আপনার secrets দেখতে পাচ্ছে কি না পরীক্ষা করুন:

docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'

এতে .env value প্রতিস্থাপিত অবস্থায় ফাইলটি দেখাবে। কোনো value খালি থাকলে বুঝবেন Compose .env ফাইলটি পড়ছে না। সাধারণত আপনি অন্য directory থেকে command চালালে এমন হয়।

অ্যাডমিন bootstrap variable-গুলো আসলে কী করে

Planka 1.13 থেকে আপনাকে কোনো administrator তৈরি করে দেওয়া হয় না। তাই নতুন database-এ লগ ইন করার মতো কেউ থাকে না। DEFAULT_ADMIN_* group এই সমস্যা সমাধানের দুটি উপায়ের একটি।

শুরু হওয়ার সময় Planka DEFAULT_ADMIN_EMAIL-এর সঙ্গে মিলে এমন user খোঁজে। এমন user না থাকলে, এর সঙ্গে সেট করা password, display name এবং username ব্যবহার করে একটি user তৈরি করে। পরবর্তীবার শুরু হলেও এই variable-গুলোর ভিত্তিতে মিলে যাওয়া account আপডেট করে। DEFAULT_ADMIN_PASSWORD সেট করা থাকলে password reset-ও করে।

DEFAULT_ADMIN_EMAIL আরও একটি কাজ করে, যা অনেকের নজর এড়ায়। এই variable সেট থাকা অবস্থায় এর নির্ধারিত account-এর name, role বা email address interface-এর মাধ্যমে পরিবর্তন করা যায় না। Account-টি delete-ও করা যায় না। এটি একটি lock-out guard। এই কারণেই UI-তে account-টির নাম বা email address পরিবর্তন করতে পারবেন না। Variable-টি সরিয়ে restart করুন। এরপর account-টি সাধারণ admin হয়ে যাবে এবং অন্য যেকোনো account-এর মতো edit করা যাবে।

Password-এর লাইনটি সতর্কতার সঙ্গে ব্যবহার করুন। environment:-এর অধীনে থাকা যেকোনো তথ্য container-এ docker inspect চালাতে পারে এমন ব্যক্তি পড়তে পারে। তাই DEFAULT_ADMIN_PASSWORD স্থায়ীভাবে সেখানে রাখা উচিত নয়। লগ ইন করুন, ওই লাইনটি মুছে দিন, আবার docker compose up -d চালান। এরপর interface-এ password পরিবর্তন করুন।

আরও পরিষ্কার পদ্ধতিতে variable-গুলো সম্পূর্ণ বাদ দেওয়া হয়। পুরো DEFAULT_ADMIN_* group-টি comment out করুন। এরপর interactive ভাবে account তৈরি করুন:

docker compose run --rm planka npm run db:create-admin-user

এটি email, password, display name এবং ঐচ্ছিক username জানতে চায়। এরপর user-টি সরাসরি database-এ লিখে। Password কখনো Compose file বা container-এর configured environment-এ যায় না। VPS-এ একাধিক ব্যক্তির shell access থাকলে এই পদ্ধতি ব্যবহার করুন। depends_on-এর কারণে command-টি আগে Postgres শুরু করে। তাই আগে কখনো চালু না হওয়া stack-এও এটি কাজ করে।

দুটি পদ্ধতির যেকোনোটি ব্যবহার করলেও Planka-এর password আপনাকেই হাতে পরিচালনা করতে হবে। Version 2.1.1 পর্যন্ত Community edition আপনার নিজস্ব single sign-on server হিসেবে চলা Authentik-এর মতো OIDC provider-এর কাছে login পরিচালনার দায়িত্ব দিতে পারত। কিন্তু August 2026-এ released version 2.2.0-তে OIDC এবং SSO PLANKA Pro-তে স্থানান্তর করা হয়েছে। একই release-এ Community edition-এ local account-এর জন্য two-factor authentication (TOTP) যোগ হয়েছে। তাই অন্তত admin account-এর জন্য এটি চালু করুন।

hostname-এর সঙ্গে না মিললে কেন BASE_URL-এ login ব্যর্থ হয়

BASE_URL হলো scheme-সহ এবং শেষে slash ছাড়া browser-এ মানুষ যে নির্দিষ্ট address লেখে। এই stack-এর জন্য সেটি হলো https://kanban.example.com। Planka এই value থেকে নিজের link এবং অনুমোদিত WebSocket origin-এর তালিকা তৈরি করে। তাই ভুল BASE_URL হলে পরিষ্কার কোনো error দেখা যায় না। বরং page load হয়, তারপর আর loading শেষ হয় না।

সাধারণ ঘটনাটি এমন: আপনি upstream example কপি করেন, BASE_URL=http://localhost:3000 অপরিবর্তিত রাখেন, এবং নিজের প্রকৃত domain-এ HTTPS ব্যবহার করে site-এ প্রবেশ করেন। Login form submit হয় এবং আপনার credential গ্রহণ করা হয়। কিন্তু board দেখা যায় না। Browser developer console খুললে /socket.io/-এ request ব্যর্থ হতে দেখবেন। কারণ socket browser page-এর origin-এ connect করে, কিন্তু server-এর origin restriction BASE_URL থেকে তৈরি origin-ই অনুমোদন করে।

TRUST_PROXY=true একই সমস্যার অন্য অংশ। Planka Traefik-এর পেছনে চলছে। তাই Docker network-এর ভিতরে প্রতিটি request proxy-এর address থেকে plain HTTP-তে Planka-তে পৌঁছায়। TRUST_PROXY না থাকলে app Traefik সেট করা X-Forwarded-Proto এবং X-Forwarded-For header উপেক্ষা করে। ফলে connection-কে insecure মনে করে এবং প্রতিটি client-কে একই shared IP address হিসেবে গণ্য করে। এটি সেট করলে app ওই header পড়ে এবং scheme সম্পর্কে browser-এর সঙ্গে সামঞ্জস্য রাখে।

Traefik অতিরিক্ত configuration ছাড়াই WebSocket proxy করে। এই কারণেও এখানে এটি ব্যবহার করা সুবিধাজনক। nginx-এ proxy-কে upgrade header, proxy_set_header Upgrade $http_upgrade এবং proxy_set_header Connection "upgrade" forward করতে হয়। তা না হলে ভিন্ন কারণে একইভাবে spinner আটকে থাকে। এগুলো সাধারণ location / block-এর মধ্যে রাখা যায়। /socket.io-এর জন্য আলাদা block ব্যবহার করাও সম্ভব, তবে তা বাধ্যতামূলক নয়।

পরে board-কে নতুন hostname-এ সরালে দুটি জিনিস একসঙ্গে পরিবর্তন করতে হবে: BASE_URL value এবং Traefik-এর Host() rule। একটি পরিবর্তন করে অন্যটি ভুলে গেলে আবার spinner আটকে যাবে। https://example.com/planka-এর মতো subpath থেকে Planka চালানো version 2.1.0 থেকে সমর্থিত, যা March 2026-এ released হয়েছে। পুরোনো tag-এ Planka-এর জন্য আলাদা subdomain ব্যবহার করুন।

Planka যেখানে attachments এবং avatars সংরক্ষণ করে

Planka 2 ব্যবহারকারী যে সবকিছু upload করেন, তা container-এর ভেতরের একটি path-এ সংরক্ষণ করে: /app/data। Attachments, user avatars এবং board background images—সবই এখানে থাকে। Version 1-এ তিনটি আলাদা directory ব্যবহার করা হতো। তাই পুরোনো নির্দেশনা থেকে কপি করা Compose file-এ এমন path mount করা হয়, যেগুলো আর নেই। ফলে নির্ধারিত data mount অনুপস্থিত থাকে।

এই একটি mount-ই upgrade-এর পর board টিকে থাকবে কি না, তা নির্ধারণ করে। Docker image /app/data-কে volume হিসেবে ঘোষণা করে। তাই Compose থেকে mount বাদ দিলে upload-গুলো anonymous volume-এ সংরক্ষিত হয়। সাধারণ up recreation-এর সময় Compose এটি সংরক্ষণ করে। কিন্তু পরে down চালিয়ে up চালালে volume-টি স্বয়ংক্রিয়ভাবে পুনরায় সংযুক্ত হয় না। Board স্বাভাবিক দেখায়, সব card থাকে, কিন্তু প্রতিটি attachment link কাজ করে না। কারণ database row-গুলো এখনও পুরোনো volume-এর file-এর দিকে নির্দেশ করে।

উপরের Compose file-এ থাকা named volume এই সমস্যা প্রতিরোধ করে। Bind mount-ও ব্যবহার করা যায়। এতে সাধারণ tool দিয়ে file backup করা সহজ হয়। তবে এর জন্য একটি অতিরিক্ত ধাপ প্রয়োজন। Container-এর ভেতরের Node process UID 1000 হিসেবে চলে। তাই host directory-এর মালিক root হলে প্রথম upload-এই permission error দেখা যায়:

sudo chown -R 1000:1000 /opt/planka/data

এই দুই পদ্ধতির পার্থক্য named volume-এর তুলনায় bind mount অংশে বিস্তারিত ব্যাখ্যা করা হয়েছে।

আপনার plan-এর disk-এ attachment রাখার জন্য পর্যাপ্ত জায়গা না থাকলে, Planka S3-compatible storage-এ file লিখতে পারে। এর জন্য S3_ENDPOINT, S3_BUCKET এবং সংশ্লিষ্ট key variable ব্যবহার করতে হয়। এটি hosted bucket অথবা অন্য একটি server-এ থাকা self-hosted MinIO object store-এর দিকে নির্দেশ করতে পারে। Team board পূরণ করার আগে এই সিদ্ধান্ত নিন। কারণ S3 সক্রিয় করলে বিদ্যমান upload migrate না করেই file read এবং write ওই backend-এ চলে যায়।

স্ট্যাক চালু করে কাজ করেছে কি না যাচাই করুন

docker compose pull
docker compose up -d
docker compose ps

docker compose ps-এ postgres হিসেবে healthy এবং planka হিসেবে running দেখা উচিত। Planka যদি বারবার restart হয়, প্রথমে database connection পরীক্ষা করুন, অ্যাপ নয়।

docker compose logs -f planka

সফল প্রথম boot-এ database migration চলে। তবে production configuration-এ noShip: true সেট করা থাকে এবং port 1337-এর তথ্য দেওয়া startup message দেখানো হয় না। লগের ওপর নির্ভর না করে সরাসরি Postgres-কে জিজ্ঞাসা করে schema সত্যিই তৈরি হয়েছে কি না নিশ্চিত করুন:

docker compose exec postgres psql -U planka -d planka -c '\dt'

table list-এ board এবং card থাকলে বোঝা যায় migration চলেছে। "Did not find any relations" বার্তার অর্থ Planka কখনো database-এ সংযোগ করেনি। তাই আপনার .env-এর POSTGRES_USER এবং POSTGRES_PASSWORD মানের সঙ্গে DATABASE_URL তুলনা করুন।

এরপর VPS থেকে নয়, নিজের মেশিন থেকে route পরীক্ষা করুন:

curl -I https://kanban.example.com

HTTP/2 200-এর অর্থ Traefik একটি certificate ধরে রেখেছে এবং container-এ পৌঁছাতে পারছে। Traefik থেকে দেওয়া 404-এর অর্থ কোনো router request-এর সঙ্গে মেলেনি। আপনি যে hostname ব্যবহার করেছেন, Host() rule সেটির সঙ্গে মেলে না, অথবা Traefik label-গুলো গ্রহণ করেনি। 502-এর অর্থ router মিলে গেছে, কিন্তু Traefik container-এ পৌঁছাতে পারেনি। যেমন container-টি proxy network-এ যুক্ত না থাকলে এমন হতে পারে। এখন site খুলে admin account দিয়ে লগ ইন করুন।

প্রতিটি version bump-এর আগে pg_dump নিন

আপনার board-এর ডেটা দুটি আলাদা store-এ থাকে। তাই backup-এ Postgres database এবং planka-data volume—দুটিই অন্তর্ভুক্ত করতে হবে। Stack চালু থাকা অবস্থায় database dump নিন।

docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"

-T Compose-এর default pseudo-terminal allocation বন্ধ করে। ফলে dump একটি সাধারণ output stream-এ থাকে।

এরপর uploads-এর backup নিন। প্রথমে আসল volume name খুঁজে বের করুন, কারণ Compose project directory name যোগ করে volume name তৈরি করে।

docker volume ls | grep planka
docker run --rm -v planka_planka-data:/data -v "$PWD":/backup alpine \
  tar czf /backup/planka-files-$(date +%F).tgz -C /data .

Project-এর repository-তে docker-backup.sh এবং docker-restore.sh-ও রয়েছে। Official documentation-এ এগুলো nightly cron job-এ চালানোর নির্দেশ দেওয়া হয়েছে। যেকোনো একটি পদ্ধতি ব্যবহার করতে পারেন। তবে যে backup কখনও restore করে পরীক্ষা করা হয়নি, সেটি নির্ভরযোগ্য backup নয়। তাই একবার একটি scratch VPS-এ backup restore করে নিশ্চিত করুন যে আপনি login করতে এবং একটি attachment খুলতে পারছেন। Upload গ্রহণ করে এমন প্রতিটি Compose app-এ একই ধরনের দুটি store থাকে। তাই পরে যদি আপনার support desk-এর একই box-এ Chatwoot চালান, এখানে তৈরি করা routine সামান্য volume name পরিবর্তন করেই ব্যবহার করতে পারবেন।

প্রতিটি version change-এর ঠিক আগে dump নিন। গত রাতের backup এবং যে migration চালাতে যাচ্ছেন তার ঠিক আগের backup এক জিনিস নয়।

tag নির্দিষ্ট করুন এবং release notes পড়ুন

ওই file-এ থাকা দুটি image tag ইচ্ছাকৃতভাবে নির্দিষ্ট করা হয়েছে।

ghcr.io/plankanban/planka:2.2.1 একটি নির্দিষ্ট release, যা October 2026 পর্যন্ত বর্তমান। Community 2.3.0 November 4, 2026-এ security fix-সহ প্রকাশিত হয়েছে এবং upstream update করার পরামর্শ দিয়েছে। Community 2.3.1 November 5, 2026-এ প্রকাশিত হয়। এতে username না থাকা কোনো member-সহ board-এ card description edit করার সময় হওয়া crash ঠিক করা হয়েছে। Upstream নতুন release প্রকাশ করলে latest পরিবর্তিত হয়। তাই নিয়মিত docker compose pull আপনার বেছে না নেওয়া সময়ে schema migration চালিয়ে দিতে পারে। ওই সংখ্যা পরিবর্তনের আগে release notes পড়ুন। Breaking change এবং security fix-এর বিবরণ সেখানেই থাকে। Version 2.0.3 security release হিসেবে প্রকাশিত হয়েছিল। তাই এটি অজান্তে গ্রহণ না করে আগে পড়ে নেওয়া উচিত। Version 2.2.1-ও একই ধরনের release; এটি August 2026-এ প্রকাশিত হয় এবং local file storage ব্যবহার করা instance-এ logged-in user-কে যেকোনো file পড়ার সুযোগ দেওয়া path traversal flaw ঠিক করে। এই guide-এ সেই setup ব্যবহার করা হয়েছে। Advisory-তে 2.1.1 এবং তার আগের version-গুলোকে affected বলা হয়েছে। আপনি যদি 2.1.x থেকে আসেন, আগে 2.2.0-এর notes পড়ুন। এই release এমন user-দের deactivate করে যারা শুধু SSO-এর মাধ্যমে sign in করেছিল, যতক্ষণ না কোনো admin তাদের password দিয়ে reactivates করেন। এখানে pinning করা সহজ, কারণ upstream image প্রকাশ করে। কোনো project image প্রকাশ না করলে একই discipline অতিরিক্ত একটি ধাপসহ প্রয়োগ করতে হবে, যেমন checkout করা git tag থেকে server-এ তৈরি openGym-এর ক্ষেত্রে।

postgres:16-alpine major version-এ pinned রাখার কারণ আরও গুরুত্বপূর্ণ। Postgres তার data directory-তে major version-নির্ভর format ব্যবহার করে। অন্য major version দিয়ে লেখা data directory server খুলতে অস্বীকার করে। postgres:latest লিখে tag-কে 16 পেরিয়ে যেতে দিলে container চালু হবে না। উদাহরণ হিসেবে, 17 image এই error-এ থেমে যায়:

FATAL:  database files are incompatible with server
DETAIL:  The data directory was initialized by PostgreSQL version 16, which is not compatible with this version 17.

কোনো data হারায় না। Restart করেও সমস্যার সমাধান হয় না। নতুন Postgres major version-এ যেতে হলে পুরোনো version থেকে dump নিয়ে নতুন version-এর fresh data directory-তে restore করতে হবে। এটি একটি pg_upgrade run। এতে dump ছাড়াই data convert করা যায়, তবে পুরোনো ও নতুন server binary একসঙ্গে available থাকতে হবে। আরেকটি উপায় হলো নতুন version চালানো server-এ logical replication করা এবং পরে switchover করা। প্রতিটি পদ্ধতিই পরিকল্পিত migration। Image pull-এর পার্শ্বপ্রতিক্রিয়া হিসেবে এটি করা উচিত নয়। Logical replication ব্যবহার করলে নতুন server data সমন্বয় করার সময় পুরোনো server চালু রাখা যায়।

আপনি যদি নতুন করে শুরু না করে বিদ্যমান Planka 1.x install upgrade করেন, সেই upgrade-এর জন্য project documentation-এ আলাদা documented procedure আছে। আগে backup না নিলে version 1-এ ফেরার কোনো উপায় নেই।

ব্যর্থতার ধরন এবং যে বার্তাগুলো দেখবেন

Planka বারবার restart হয় এবং log-এ database-এর নাম দেখা যায়। DATABASE_URL-এ থাকা credential-গুলো Postgres environment-এর সঙ্গে মেলে না। মনে রাখবেন, data directory প্রথমবার initialize করার সময়ই শুধু POSTGRES_PASSWORD প্রয়োগ করা হয়। তাই প্রথম boot ব্যর্থ হওয়ার পরে variable ঠিক করলেও কোনো পরিবর্তন হবে না। Configured password-এর সঙ্গে মিলিয়ে নিতে ALTER ROLE ব্যবহার করে database role-এর password পরিবর্তন করুন। db-data volume মুছে ফেলা কেবল এমন disposable installation-এর ক্ষেত্রে উপযুক্ত, যেখানে সংরক্ষণ করার মতো কোনো data নেই।

Login সফল হয়, কিন্তু board কখনো load হয় না। BASE_URL browser bar-এ থাকা address-এর সঙ্গে মেলে না। তাই server socket-এর origin প্রত্যাখ্যান করে। Browser console-এ /socket.io/-এ ব্যর্থ request দেখা যায়।

অন্য সবকিছু কাজ করলেও upload ব্যর্থ হয়। Bind mount-টি root-এর মালিকানাধীন। Host directory-তে sudo chown -R 1000:1000 চালিয়ে container restart করুন।

Upgrade-এর পরে attachment অদৃশ্য হয়ে গেছে। /app/data মূল uploads volume-এর সঙ্গে attach করা হয়নি। সেই volume আবার attach করুন অথবা backup থেকে file restore করুন। এরপর image tag পরিবর্তন করার আগে named volume ব্যবহার করুন।

Traefik 404 ফেরত দেয়। কোনো router request-এর সঙ্গে মেলেনি। Host() rule আপনার DNS record-এর সঙ্গে মেলে না, অথবা label-গুলো Traefik পর্যন্ত পৌঁছায়নি। প্রতিস্থাপনের পরে label-গুলো দেখতে docker compose config ব্যবহার করুন। এখানেই typo সহজে ধরা পড়ে। 502-এর অর্থ route মিলে গেছে, কিন্তু container-এ পৌঁছানো যায়নি। তাই container-টি proxy network-এ আছে কি না পরীক্ষা করুন।

Notification বা webhook কখনো পৌঁছায় না। Planka 2 তার outgoing HTTP request একটি internal filter-এর মাধ্যমে পাঠায়। Default block list-এ localhost এবং postgres অন্তর্ভুক্ত থাকে। localhost-এর দিকে পাঠানো webhook নকশা অনুযায়ী block হয়। OUTGOING_ALLOWED_HOSTS সেট করার পরে সেই তালিকায় না থাকা প্রতিটি host-ও block হয়। Filter সরানোর পরিবর্তে webhook-টি অন্য container-এর service name-এ পাঠান। Allow list ব্যবহার করলে সেই নামটি OUTGOING_ALLOWED_HOSTS-এ যোগ করুন।

চলমান অবস্থায় এর operational load কম। Release notes পর্যবেক্ষণ করুন এবং প্রতিটি upgrade-এর আগে database dump নিন। restart: unless-stopped-এর কারণে reboot-এর পরে stack নিজে থেকেই ফিরে আসে, যদি Docker service-টি boot-এর সময় enabled থাকে। এটি না হলে reboot-এর পরে ফিরে আসা Compose stack অংশে সংশ্লিষ্ট পরিস্থিতিগুলো ব্যাখ্যা করা হয়েছে।

FAQ

Log in করার পর Planka অনির্দিষ্টকাল load হতে থাকে কেন?

Credentials গ্রহণ করা হয়েছে, কিন্তু live connection তৈরি হয়নি। Browser page-এর origin-এ socket খোলে। Planka তার allowed socket origin BASE_URL থেকে নির্ধারণ করে। তাই site-এ https://kanban.example.com দিয়ে পৌঁছানোর সময় ওই variable http://localhost:3000 রেখে দিলে server connection প্রত্যাখ্যান করে। Developer console-এ /socket.io/-এ ব্যর্থ request দেখা যায়। BASE_URL-এ trailing slash ছাড়া exact public address সেট করুন। Reverse proxy-এর X-Forwarded-Proto header app যাতে গ্রহণ করে, তার জন্য TRUST_PROXY=true যোগ করুন। এরপর docker compose up -d run করুন।

প্রথম Planka admin user কীভাবে তৈরি করব?

Version 1.13 থেকে কোনো administrator স্বয়ংক্রিয়ভাবে তৈরি হয় না। হয় matching password, name এবং username variable-সহ DEFAULT_ADMIN_EMAIL সেট করে stack start করুন, অথবা docker compose run --rm planka npm run db:create-admin-user run করে prompt-এর উত্তর দিন। Shared server-এ interactive command বেশি নিরাপদ। কারণ password container-এর configured environment-এ প্রবেশ করে না, যেখানে docker inspect এটি পড়তে পারে। পরে DEFAULT_ADMIN_EMAIL সেট করে রাখলে ওই account-এর name, role এবং email address পরিবর্তন করা যায় না। Interface থেকেও account-টি delete করা যায় না। Setup শেষ হলে DEFAULT_ADMIN_PASSWORD সরিয়ে ফেলুন। এটি রেখে দিলে startup-এর সময় matching account-এর password reset হয়।

Planka attachment এবং avatar কোথায় সংরক্ষণ করে?

Planka 2-এ attachment, user avatar এবং board background-সহ সব uploaded file container-এর ভিতরে /app/data-এর অধীনে থাকে। ওই path-টি named volume-এ mount করুন। Explicit mount না থাকলে Docker image anonymous volume ব্যবহার করে। docker compose down-এর পরবর্তী docker compose up স্বয়ংক্রিয়ভাবে ওই volume-এ আবার সংযুক্ত হয় না। Bind mount-ও কাজ করে। তবে Node process UID 1000 হিসেবে চলে। তাই host directory-তে sudo chown -R 1000:1000 run করুন। তা না হলে permission error-এর কারণে upload ব্যর্থ হবে।

Self-hosted Planka-এর কত RAM প্রয়োজন?

Project-এর technical FAQ ছোট team-এর জন্য অন্তত 2 GB RAM এবং 10 GB storage সুপারিশ করে। Default Docker deployment-এ একটি Node process, প্রতি open connection-এর জন্য একটি backend process-সহ একটি Postgres server এবং outgoing request filtering-এর জন্য একটি internal Squid proxy চলে। স্বাভাবিক এক সপ্তাহের পরে docker stats --no-stream run করুন এবং নিজের সংখ্যার ভিত্তিতে capacity নির্ধারণ করুন। Memory-এর চেয়ে disk বেশি নজরে রাখুন। কারণ attachment-ই বেশি বাড়ে।

Data না হারিয়ে Planka কীভাবে upgrade করব?

Upgrade-এর ঠিক আগে database dump করুন এবং uploads volume archive করুন। গত রাতের scheduled backup-এর ওপর নির্ভর করবেন না। docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql ব্যবহার করুন এবং redirected output-এর জন্য pseudo-terminal allocation বন্ধ রাখতে -T রাখুন। যে version-গুলো skip করছেন, প্রতিটির release notes পড়ুন। Image tag latest না রেখে নির্দিষ্ট release-এ পরিবর্তন করুন। এরপর docker compose pull এবং docker compose up -d run করুন এবং migration-এর জন্য log monitor করুন। Postgres tag তার major version-এ pinned রাখুন। কারণ অন্য major version দিয়ে লেখা data directory server খুলতে অস্বীকার করে।

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