SSD Nodes Learn Hosting plans →
تعلیمی Matt Connorتحریر: Matt Connor

Planka کو VPS پر Docker Compose سے کیسے چلائیں؟

VPS پر Planka کو Docker Compose، Postgres اور Traefik کے ساتھ deploy کریں۔ admin bootstrap variables اور BASE_URL کی وہ ترتیب جانیں جو login توڑ دیتی ہے۔

خود میزبانی Planka سے آپ کو کیا ملتا ہے

خود میزبانی کے ذریعے آپ کی ٹیم کو ایسا Kanban board ملتا ہے جس میں card، list اور label کا وہی ماڈل استعمال ہوتا ہے جس سے لوگ پہلے ہی Trello میں واقف ہیں، اور یہ آپ کے زیرِ انتظام VPS پر چلتا ہے۔ seat limits اور per-user billing نہیں ہوتی، کیونکہ واحد لاگت server کی ہوتی ہے۔ یہ guide اسے Traefik کے پیچھے Docker Compose کے ساتھ deploy کرتی ہے، data کے لیے Postgres اور صارفین کی upload کردہ ہر file کے لیے named volume استعمال کرتے ہوئے۔

Planka 2، project کے اپنے Fair Use License کے تحت release ہوتا ہے۔ project اسے open source کے بجائے source-available قرار دیتا ہے۔ اسے اپنی organisation کے اندرونی projects کے لیے چلانے کی اجازت ہے۔ اسے third parties کو commercial hosted service کے طور پر فراہم کرنے کے لیے Pro یا Enterprise licence درکار ہے۔

میرے پیش نظر وہ team ہے جس کے ارکان 2 سے 5 ہیں اور جو Trello کے free tier سے منتقل ہو رہی ہے۔ اگر آپ ابھی یہ طے کر رہے ہیں کہ کون سا board چلانا ہے تو پہلے خود میزبانی والے Trello متبادلوں کا موازنہ پڑھیں۔ یہ guide فرض کرتی ہے کہ انتخاب پہلے ہی ہو چکا ہے اور صرف deploy کا طریقہ بیان کرتی ہے۔

آپ کو ایسا VPS درکار ہے جس پر Docker Engine اور Compose plugin چل رہے ہوں، نیز اس VPS کی طرف نشاندہی کرنے والا DNS A record بھی چاہیے۔ اس server پر Traefik instance بھی پہلے سے موجود ہونا چاہیے جو TLS (transport layer security) termination کر رہا ہو۔ اگر Traefik ابھی موجود نہیں ہے تو پہلے متعدد Compose apps کے سامنے Traefik reverse proxy ترتیب دیں، اور اگر نیچے دی گئی file غیر مانوس لگے تو VPS کے لیے Docker Compose کی بنیادی باتیں پڑھیں۔

Planka کو کتنے VPS کی ضرورت ہے؟

پروجیکٹ کا تکنیکی FAQ چھوٹی ٹیموں کے لیے کم از کم 2 GB RAM اور 10 GB اسٹوریج کی سفارش کرتا ہے، لہذا ان اعداد و شمار کو پیمائش کے بجائے ایک ابتدائی نقطہ سمجھیں۔

جو کچھ اصل میں چلتا ہے وہ چھوٹا ہے: ایک Node.js پروسیس جو API اور بلٹ ان فرنٹ اینڈ کو سروس فراہم کرتا ہے، اور ایک Postgres سرور جو ڈیٹا کو محفوظ رکھتا ہے، جو ایک نگرانی کرنے والے پروسیس کے ساتھ ساتھ ہر کھلے کنکشن کے لیے ایک بیک اینڈ پروسیس چلاتا ہے۔ Planka کنٹینر کے اندر ایک چھوٹا پراکسی پروسیس بھی چلتا ہے تاکہ اس کی آؤٹ گوئنگ درخواستوں کو فلٹر کیا جا سکے۔ 2 GB کا پلان چھوٹی ٹیموں کے لیے پروجیکٹ کی RAM کی سفارش سے مطابقت رکھتا ہے۔ ایک بورڈ ایک ہلکا پڑوسی ہے، لہذا اگر اسی VPS پر آپ کی ٹیم کی دستاویزات بھی رکھی جانی ہیں، تو پہلے اس ایپ کے لیے سائز کا تعین کریں: running AFFiNE as a Notion-style workspace کو Planka کی کسی بھی ضرورت سے پہلے خود اپنے لیے چند گیگا بائٹس درکار ہوتے ہیں۔

میموری کا سائز طے کرنے سے پہلے ڈسک کا سائز طے کریں، کیونکہ اٹیچمنٹس وہ حصہ ہیں جو بڑھتا ہے۔ اس پیراگراف پر بھروسہ کرنے کے بجائے اپنے انسٹینس کی پیمائش خود کریں:

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

پہلا کمانڈ فی کنٹینر لائیو میموری اور CPU کو پرنٹ کرتا ہے۔ دوسرا یہ دکھاتا ہے کہ ہر والیوم کتنی جگہ لے رہا ہے۔ دونوں ریڈنگز ایک عام کام کے ہفتے کے بعد لیں، نہ کہ انسٹالیشن والے دن، کیونکہ ایک آئیڈل بورڈ آپ کو آپ کی ٹیم کے بارے میں کچھ نہیں بتاتا۔

Compose فائل لکھیں

ڈائریکٹری بنائیں اور اس کی ملکیت حاصل کریں، تاکہ آپ کو کبھی بھی ان فائلوں کو sudo کے ذریعے ایڈٹ نہ کرنا پڑے۔

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

سیکریٹس کو Compose فائل کے ساتھ ایک .env فائل میں جنریٹ کریں۔ Compose خود بخود اس فائل کو پڑھتا ہے اور ویلیوز کو تبدیل (substitute) کر دیتا ہے۔

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 کا انتخاب جان بوجھ کر کیا گیا ہے۔ ایک ہیکس اسٹرنگ میں صرف ہندسے اور a سے f تک کے حروف ہوتے ہیں، لہذا یہ اس DATABASE_URL کنکشن اسٹرنگ کو خراب نہیں کر سکتی جس میں اسے پیسٹ کیا جاتا ہے۔ معیاری Base64 میں سلیش، پلس کا نشان اور پیڈنگ کے لیے برابر کا نشان ہو سکتا ہے، لیکن اس میں کبھی بھی @ کا نشان نہیں ہوتا؛ کنکشن URL میں خصوصی معنی رکھنے والے کریکٹرز کو percent-encoding کی ضرورت ہوتی ہے۔ اس کا وسیع تر طریقہ Compose فائل سے سیکریٹس کو دور رکھنا میں بیان کیا گیا ہے۔

اب docker-compose.yml۔ kanban.example.com کو دونوں جگہوں پر اپنے ہوسٹ نیم سے تبدیل کریں۔

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 سروس پر کوئی ports: بلاک نہیں ہے۔ Traefik کنٹینر تک proxy نیٹ ورک کے ذریعے پہنچتا ہے، اس لیے پورٹ 1337 کبھی بھی ہوسٹ پر پبلش نہیں ہوتی۔ اسے پبلش کرنے سے کوئی بھی آپ کی پراکسی اور سرٹیفکیٹ کو بائی پاس کر سکتا ہے۔
  • loadbalancer.server.port=1337 کنٹینر کے اندر پورٹ کا نام بتاتا ہے۔ Planka 1337 پر لسن کرتا ہے، اور اپ اسٹریم مثال صرف 3000 پر اس تک پہنچتی ہے کیونکہ وہ پورٹ کو ہوسٹ پر میپ کرتی ہے۔ یہاں کوئی ہوسٹ میپنگ نہیں ہے، اس لیے Traefik کو کنٹینر پورٹ کے بارے میں بتانا ضروری ہے۔
  • condition: service_healthy کا تعلق Postgres ہیلتھ چیک سے ہے۔ اس کے بغیر Planka ڈیٹا بیس کے کنکشن قبول کرنے سے پہلے ہی شروع ہو جاتا ہے، اپنی پہلی کوئری میں ناکام ہو کر بند ہو جاتا ہے، جو کہ کریش لوپ کی طرح دکھائی دیتا ہے۔ اس کی تفصیلات Compose ہیلتھ چیکس اور اسٹارٹ اپ آرڈرنگ میں موجود ہیں۔
  • ڈیٹا بیس سروس کا نام جان بوجھ کر postgres رکھا گیا ہے۔ Planka 2 اپنی آؤٹ گوئنگ درخواستوں کو ایک انٹرنل فلٹر کے ذریعے روٹ کرتا ہے جس کی ڈیفالٹ بلاک لسٹ localhost,postgres ہے۔ سروس کا نام تبدیل کرنے سے آپ خاموشی سے اپنے ڈیٹا بیس کو اس لسٹ سے نکال دیں گے۔

شروع کرنے سے پہلے چیک کریں کہ آیا Compose آپ کے سیکریٹس کو دیکھ سکتا ہے:

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

یہ کمانڈ وہ فائل پرنٹ کرتی ہے جس میں .env ویلیوز پہلے سے تبدیل شدہ ہوتی ہیں۔ خالی ویلیو کا مطلب ہے کہ Compose .env فائل کو نہیں پڑھ رہا، جس کی عام وجہ یہ ہوتی ہے کہ آپ کمانڈ کسی دوسری ڈائریکٹری سے چلا رہے ہیں۔

ایڈمن بوٹ اسٹریپ ویری ایبلز اصل میں کیا کرتے ہیں

Planka 1.13 کے بعد سے آپ کے لیے خودکار طور پر کوئی ایڈمنسٹریٹر نہیں بنایا جاتا، لہذا ایک نئے ڈیٹا بیس میں کوئی بھی ایسا صارف نہیں ہوتا جو لاگ ان کر سکے۔ DEFAULT_ADMIN_* گروپ اس مسئلے کو حل کرنے کے دو طریقوں میں سے ایک ہے۔

اسٹارٹ اپ پر Planka ایک ایسے صارف کو تلاش کرتا ہے جو DEFAULT_ADMIN_EMAIL سے مطابقت رکھتا ہو۔ اگر ایسا کوئی صارف نہ ہو، تو یہ اس کے ساتھ سیٹ کردہ پاس ورڈ، ڈسپلے نام اور یوزر نیم کا استعمال کرتے ہوئے ایک اکاؤنٹ بنا دیتا ہے۔ بعد کے اسٹارٹ اپس پر، یہ ان ویری ایبلز سے مطابقت رکھنے والے اکاؤنٹ کو اپ ڈیٹ بھی کرتا ہے، بشمول اس وقت پاس ورڈ ری سیٹ کرنا جب DEFAULT_ADMIN_PASSWORD سیٹ رہے۔

DEFAULT_ADMIN_EMAIL ایک دوسرا کام بھی کرتا ہے جو اکثر لوگوں کے لیے الجھن کا باعث بنتا ہے۔ جب تک یہ ویری ایبل سیٹ رہتا ہے، اس اکاؤنٹ کا نام، کردار یا ای میل ایڈریس انٹرفیس کے ذریعے تبدیل نہیں کیا جا سکتا، اور نہ ہی اسے ڈیلیٹ کیا جا سکتا ہے۔ یہ ایک لاک آؤٹ گارڈ ہے، اور یہی وجہ ہے کہ آپ اس اکاؤنٹ کا نام تبدیل نہیں کر سکتے یا UI میں اس کا ای میل ایڈریس نہیں بدل سکتے۔ ویری ایبل کو ہٹا کر ری اسٹارٹ کریں، تو اکاؤنٹ ایک عام ایڈمن بن جائے گا جسے آپ کسی بھی دوسرے اکاؤنٹ کی طرح ایڈٹ کر سکتے ہیں۔

پاس ورڈ والی لائن کے معاملے میں احتیاط برتیں۔ environment: کے تحت کوئی بھی چیز ہر اس شخص کے لیے قابلِ مطالعہ ہے جو کنٹینر پر docker inspect چلا سکتا ہے، لہذا DEFAULT_ADMIN_PASSWORD کو وہاں مستقل طور پر نہیں ہونا چاہیے۔ لاگ ان کریں، اس لائن کو ڈیلیٹ کریں، دوبارہ docker compose up -d چلائیں، اور پھر انٹرفیس میں اپنا پاس ورڈ تبدیل کر لیں۔

صاف ستھرا طریقہ یہ ہے کہ ویری ایبلز کو مکمل طور پر چھوڑ دیا جائے۔ پورے DEFAULT_ADMIN_* گروپ کو کمنٹ آؤٹ کر دیں، اور پھر انٹرایکٹو طریقے سے اکاؤنٹ بنائیں:

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

یہ ای میل، پاس ورڈ، ڈسپلے نام اور اختیاری یوزر نیم کے لیے پرامپٹ کرتا ہے، اور صارف کو براہ راست ڈیٹا بیس میں لکھ دیتا ہے۔ پاس ورڈ کبھی بھی Compose فائل یا کنٹینر کے کنفیگرڈ ماحول کو نہیں چھوتا۔ اگر VPS تک ایک سے زیادہ افراد کی شیل تک رسائی ہو تو یہ طریقہ استعمال کریں۔ یہ کمانڈ depends_on کی وجہ سے پہلے Postgres کو شروع کرتی ہے، لہذا یہ ایسے اسٹیک پر بھی کام کرتی ہے جو پہلے کبھی آن نہ ہوا ہو۔

دونوں طریقے آپ کو Planka کے پاس ورڈز دستی طور پر مینیج کرنے پر مجبور کرتے ہیں۔ ورژن 2.1.1 تک Community ایڈیشن لاگ انز کو OIDC پرووائیڈر کے حوالے کر سکتا تھا جیسے کہ Authentik جو آپ کے اپنے سنگل سائن آن سرور کے طور پر چل رہا ہو، لیکن ورژن 2.2.0، جو اگست 2026 میں ریلیز ہوا، نے OIDC اور SSO کو PLANKA Pro میں منتقل کر دیا۔ اسی ریلیز میں Community ایڈیشن کو جو چیز ملی وہ مقامی اکاؤنٹس کے لیے ٹو-فیکٹر آتھنٹیکیشن (TOTP) ہے، لہذا کم از کم ایڈمن اکاؤنٹ کے لیے اسے ضرور آن کریں۔

BASE_URL کا hostname سے مماثل نہ ہونا لاگ ان کو کیوں ناکام بناتا ہے

BASE_URL وہ درست پتہ ہے جو صارفین براؤزر میں ٹائپ کرتے ہیں، جس میں scheme شامل ہوتی ہے اور آخر میں کوئی سلیش نہیں ہوتا۔ اس stack کے لیے یہ https://kanban.example.com ہے۔ Planka اس ویلیو سے اپنے لنکس اور مجاز WebSocket origins کی فہرست تیار کرتا ہے، جس کا مطلب ہے کہ غلط BASE_URL آپ کو کوئی واضح error نہیں دیتا۔ اس کے بجائے، آپ کو ایک ایسا صفحہ ملتا ہے جو لوڈ تو ہوتا ہے لیکن کبھی مکمل نہیں ہوتا۔

عام صورتحال یہ ہے: آپ upstream مثال کاپی کرتے ہیں، BASE_URL=http://localhost:3000 کو ویسے ہی چھوڑ دیتے ہیں، اور اپنی اصل ڈومین پر HTTPS کے ذریعے سائٹ تک رسائی حاصل کرتے ہیں۔ لاگ ان فارم submit ہو جاتا ہے اور آپ کے credentials قبول کر لیے جاتے ہیں۔ لیکن بورڈ کبھی ظاہر نہیں ہوتا۔ براؤزر کا developer console کھولیں تو آپ کو /socket.io/ کی درخواستیں ناکام ہوتی نظر آئیں گی، کیونکہ socket براؤزر پیج کے origin سے جڑتا ہے لیکن سرور کی origin restriction اس origin کی اجازت دیتی ہے جو BASE_URL سے اخذ کیا گیا ہے۔

TRUST_PROXY=true اسی مسئلے کا دوسرا حصہ ہے۔ Planka، Traefik کے پیچھے موجود ہے، اس لیے ہر درخواست Docker نیٹ ورک کے اندر plain HTTP کے ذریعے proxy کے پتے سے اس تک پہنچتی ہے۔ TRUST_PROXY کے بغیر، ایپ ان X-Forwarded-Proto اور X-Forwarded-For ہیڈرز کو نظر انداز کر دیتی ہے جو Traefik سیٹ کرتا ہے، لہذا یہ سمجھتی ہے کہ کنکشن غیر محفوظ ہے اور ہر کلائنٹ کو ایک مشترکہ IP ایڈریس کے طور پر برتاؤ کرتی ہے۔ اس کے سیٹ ہونے پر، ایپ ان ہیڈرز کو پڑھتی ہے اور scheme کے بارے میں براؤزر سے متفق ہو جاتی ہے۔

Traefik بغیر کسی اضافی کنفیگریشن کے WebSockets کو پراکسی کرتا ہے، یہی وجہ ہے کہ یہاں اسے ترجیح دی جاتی ہے۔ nginx پر، پراکسی کو upgrade ہیڈرز، proxy_set_header Upgrade $http_upgrade اور proxy_set_header Connection "upgrade" کو آگے بھیجنا پڑتا ہے، ورنہ آپ کو مختلف وجہ سے وہی پھنسا ہوا spinner نظر آئے گا۔ انہیں عام location / بلاک میں رکھا جا سکتا ہے؛ /socket.io کے لیے ایک الگ بلاک بھی کام کرتا ہے لیکن یہ ضروری نہیں ہے۔

بورڈ کو بعد میں کسی نئے hostname پر منتقل کرنے کا مطلب ہے کہ دو چیزوں کو ایک ساتھ تبدیل کیا جائے: BASE_URL کی ویلیو اور Traefik کا Host() رول۔ ایک کو تبدیل کریں اور دوسرے کو بھول جائیں، تو آپ دوبارہ spinner پر واپس آ جائیں گے۔ Planka کو کسی subpath جیسے https://example.com/planka سے سرو کرنا ورژن 2.1.0 سے ممکن ہے، جو مارچ 2026 میں ریلیز ہوا تھا۔ پرانے ٹیگز پر، اسے اس کا اپنا subdomain دیں۔

Planka اٹیچمنٹس اور اوتار کہاں محفوظ کرتا ہے

Planka 2 صارف کی اپ لوڈ کردہ ہر چیز کو کنٹینر کے اندر ایک ہی پاتھ /app/data پر محفوظ کرتا ہے۔ اٹیچمنٹس، صارف کے اوتار اور بورڈ کے پس منظر کی تصاویر سب اسی کے نیچے موجود ہوتی ہیں۔ ورژن 1 میں تین الگ الگ ڈائریکٹریز استعمال ہوتی تھیں، اس لیے پرانی تحریروں سے کاپی کی گئی Compose فائل ایسے پاتھس کو ماؤنٹ کرتی ہے جو اب موجود نہیں ہیں، اور مطلوبہ ڈیٹا ماؤنٹ غائب رہتا ہے۔

یہ واحد ماؤنٹ اس فرق کا باعث ہے کہ آیا بورڈ اپ گریڈ کے بعد محفوظ رہے گا یا آپ کا دن خراب ہو جائے گا۔ Docker امیج /app/data کو بطور volume ظاہر کرتی ہے، اس لیے Compose سے ماؤنٹ کو حذف کرنے سے اپ لوڈز ایک گمنام (anonymous) volume میں چلے جاتے ہیں۔ Compose عام up ری کریشن کے دوران اسے محفوظ رکھتا ہے، لیکن بعد میں آنے والا down اور اس کے بعد up اسے خود بخود دوبارہ منسلک نہیں کرتا۔ بورڈ واپس آ جاتا ہے اور ٹھیک نظر آتا ہے، کارڈز اپنی جگہ ہوتے ہیں، لیکن ہر اٹیچمنٹ لنک ناکارہ ہو جاتا ہے، کیونکہ ڈیٹا بیس کی قطاریں اب بھی پرانے volume میں موجود فائلوں کی طرف اشارہ کر رہی ہوتی ہیں۔

اوپر دی گئی Compose فائل میں موجود named volume اس مسئلے سے بچاتا ہے۔ ایک bind mount بھی کام کرتا ہے اور عام ٹولز کے ساتھ فائلوں کا بیک اپ لینا آسان بناتا ہے، لیکن اس کے لیے ایک اضافی قدم کی ضرورت ہوتی ہے۔ کنٹینر کے اندر Node پروسیس UID 1000 کے طور پر چلتا ہے، اس لیے root کی ملکیت والی ہوسٹ ڈائریکٹری پہلی اپ لوڈ پر permission error دیتی ہے:

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

ان دونوں کے درمیان موازنہ bind mounts بمقابلہ named volumes میں بیان کیا گیا ہے۔

اگر آپ کے پلان میں اٹیچمنٹس ڈسک کی گنجائش سے بڑھ جائیں، تو Planka انہیں S3_ENDPOINT، S3_BUCKET اور متعلقہ کلیدی متغیرات (key variables) کے ذریعے S3-compatible اسٹوریج پر لکھ سکتا ہے۔ یہ کسی hosted bucket یا کسی دوسرے باکس پر موجود self-hosted MinIO object store کی طرف اشارہ کر سکتا ہے۔ اس کا فیصلہ ٹیم کے بورڈ بھرنے سے پہلے کریں، کیونکہ S3 کو فعال کرنے سے فائل ریڈ اور رائٹ اس بیک اینڈ پر منتقل ہو جاتے ہیں، جبکہ موجودہ اپ لوڈز خود بخود منتقل (migrate) نہیں ہوتے۔

اسٹیک شروع کریں اور تصدیق کریں کہ یہ درست طور پر چل رہا ہے

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 migrations چلتی ہیں، لیکن production configuration noShip: true مقرر کرتی ہے اور startup message کو دبا دیتی ہے جو port 1337 کی اطلاع دیتا ہے۔ Log پر بھروسا کرنے کے بجائے Postgres سے براہِ راست پوچھ کر تصدیق کریں کہ schema واقعی شامل ہو گیا ہے:

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

اگر table list میں board اور card شامل ہوں تو اس کا مطلب ہے کہ migrations چل چکی ہیں۔ "Did not find any relations" کا مطلب ہے کہ Planka نے کبھی connect نہیں کیا، اس لیے اپنے .env میں موجود DATABASE_URL کا موازنہ POSTGRES_USER اور POSTGRES_PASSWORD کی values سے کریں۔

اب route کو اپنے machine سے چیک کریں، VPS سے نہیں:

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

HTTP/2 200 کا مطلب ہے کہ Traefik کے پاس certificate موجود ہے اور وہ container تک پہنچ رہا ہے۔ Traefik کی طرف سے دیا گیا 404 اس بات کی نشاندہی کرتا ہے کہ کسی router نے request match نہیں کی: Host() rule اس hostname سے match نہیں کرتی جسے آپ نے request میں دیا، یا Traefik نے labels کو کبھی load نہیں کیا۔ 502 کا مطلب ہے کہ router نے match کیا، لیکن Traefik container تک نہیں پہنچ سکا، مثلاً اس لیے کہ container proxy network سے attached نہیں ہے۔ اب site کھولیں اور admin account سے login کریں۔

ہر version bump سے پہلے pg_dump لیں

آپ کے بورڈ کا ڈیٹا دو الگ الگ جگہوں پر محفوظ ہوتا ہے، اس لیے بیک اپ میں دونوں کا احاطہ کرنا ضروری ہے: Postgres ڈیٹا بیس اور planka-data والیوم۔ اسٹیک کے چلتے ہوئے ڈیٹا بیس کا ڈمپ لیں۔

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

-T کمانڈ Compose کی ڈیفالٹ pseudo-terminal ایلوکیشن کو غیر فعال کر دیتی ہے، جس سے ڈمپ ایک سادہ آؤٹ پٹ اسٹریم پر رہتا ہے۔

اس کے بعد اپ لوڈز کا مرحلہ ہے۔ پہلے والیوم کا اصل نام معلوم کریں، کیونکہ Compose اس کے ساتھ پروجیکٹ ڈائریکٹری کا نام بطور پریفکس شامل کرتا ہے۔

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 .

یہ پروجیکٹ اپنی ریپوزٹری میں docker-backup.sh اور docker-restore.sh بھی فراہم کرتا ہے، اور آفیشل دستاویزات انہیں نائٹلی کرون جاب پر چلانے کا مشورہ دیتی ہیں۔ دونوں طریقے درست ہیں۔ جو طریقہ درست نہیں ہے وہ ایسا بیک اپ ہے جسے آپ نے کبھی بحال (restore) نہ کیا ہو، لہذا ایک بار کسی scratch VPS پر بیک اپ بحال کریں اور تصدیق کریں کہ آپ لاگ ان ہو سکتے ہیں اور اٹیچمنٹ کھول سکتے ہیں۔ یہی دو اسٹورز ہر اس Compose ایپ میں موجود ہوتے ہیں جو اپ لوڈز قبول کرتی ہے، لہذا اگر آپ بعد میں Chatwoot کو اپنے سپورٹ ڈیسک والے سرور پر منتقل کرتے ہیں، تو یہاں تیار کردہ معمول صرف والیوم کے نام تبدیل کر کے وہاں بھی استعمال کیا جا سکتا ہے۔

ہر ورژن کی تبدیلی سے فوراً پہلے ڈمپ چلائیں۔ کل رات کا بیک اپ اس بیک اپ جیسا نہیں ہوتا جو آپ کے مائیگریشن شروع کرنے سے پہلے لیا گیا ہو۔

Tags کو pin کریں اور release notes پڑھیں

اس file میں دونوں image tags جان بوجھ کر pinned ہیں۔

ghcr.io/plankanban/planka:2.2.1 ایک مخصوص release ہے، جو October 2026 تک موجودہ ہے۔ Community 2.3.0 کو November 4, 2026 کو security fixes کے ساتھ release کیا گیا، اور upstream update کرنے کی سفارش کرتا ہے۔ Community 2.3.1، November 5, 2026 کو release ہوئی۔ اس میں ایسے boards پر card descriptions edit کرتے وقت crash درست کیا گیا ہے جہاں کسی member کا username موجود نہیں تھا۔ latest upstream کے ہر نئے publication کے ساتھ بدلتا رہتا ہے، اس لیے معمول کی docker compose pull ایسے وقت schema migration لا سکتی ہے جب آپ نے اس کا انتخاب نہ کیا ہو۔ اس number کو تبدیل کرنے سے پہلے release notes پڑھیں، کیونکہ breaking changes اور security fixes وہیں بیان کیے جاتے ہیں۔ Version 2.0.3 کو security release کے طور پر publish کیا گیا تھا۔ یہ بالکل ایسی تبدیلی ہے جسے آپ اتفاقاً شامل ہونے دینے کے بجائے پہلے پڑھنا چاہیں گے۔ یہی بات 2.2.1 پر بھی لاگو ہوتی ہے، جو August 2026 میں release ہوئی: یہ path traversal خامی درست کرتی ہے جس کے ذریعے logged-in user ان instances پر arbitrary files پڑھ سکتا تھا جو local file storage استعمال کرتے ہیں۔ اس guide میں بھی یہی setup ہے، اور advisory کے مطابق 2.1.1 اور اس سے پہلے کے versions متاثر تھے۔ اگر آپ 2.1.x سے آ رہے ہیں تو پہلے 2.2.0 کی notes پڑھیں، کیونکہ یہ release ان users کو deactivate کر دیتی ہے جنہوں نے ہمیشہ صرف SSO کے ذریعے sign in کیا ہو، جب تک admin انہیں password دے کر دوبارہ activate نہ کرے۔ یہاں pinning آسان ہے کیونکہ upstream images publish کرتا ہے۔ جہاں project کوئی image publish نہ کرے، وہاں بھی اسی discipline کی ضرورت ہوتی ہے، لیکن ایک اضافی قدم کے ساتھ، جیسا کہ checked-out git tag سے machine پر بنائی گئی openGym کے معاملے میں۔

postgres:16-alpine کو major version پر pin کرنے کی وجہ زیادہ اہم ہے۔ Postgres اپنا data directory ایسے format میں لکھتا ہے جو major version سے وابستہ ہوتا ہے، اور server کسی دوسری major version سے لکھے گئے directory کو کھولنے سے انکار کر دیتا ہے۔ postgres:latest لکھیں، tag کو 16 سے آگے بڑھنے دیں، اور container start نہیں ہوگا۔ مثلاً 17 image اس message کے ساتھ رک جاتی ہے:

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.

کچھ بھی ضائع نہیں ہوتا، اور restart کرنے سے بھی کچھ درست نہیں ہوتا۔ نئے Postgres major version پر جانے کے لیے پرانے version سے dump لے کر نئے version کے fresh data directory میں restore کرنا ہوگا، pg_upgrade run کرنا ہوگا جو dump کے بغیر data convert کرتا ہے لیکن پرانے اور نئے server binaries کو بیک وقت دستیاب ہونے کا تقاضا کرتا ہے، یا نئے version پر چلنے والے server کو logical replication کے ذریعے data منتقل کرنا ہوگا، پھر switchover کرنا ہوگا۔ ہر طریقہ ایک منصوبہ بند migration ہے، image pull کا ضمنی نتیجہ نہیں۔ Logical replication کے دوران پرانا server چلتا رہ سکتا ہے، جبکہ نیا server data کے ساتھ ہم آہنگ ہوتا رہتا ہے۔

اگر آپ fresh setup کے بجائے موجودہ Planka 1.x install منتقل کر رہے ہیں تو اس upgrade کا اپنا documented procedure project documentation میں موجود ہے۔ پہلے سے لیا گیا backup نہ ہو تو version 1 پر واپس جانے کا کوئی طریقہ نہیں ہے۔

ناکام ہونے کے طریقے اور وہ سٹرنگز جو آپ دیکھیں گے

Planka ایک لوپ میں دوبارہ شروع ہوتا ہے اور لاگ میں ڈیٹا بیس کا نام آتا ہے۔ DATABASE_URL میں موجود اسناد Postgres کے ماحول سے میل نہیں کھاتیں۔ یاد رکھیں کہ POSTGRES_PASSWORD صرف اس وقت لاگو ہوتا ہے جب ڈیٹا ڈائریکٹری پہلی بار شروع (initialize) کی جاتی ہے، لہذا خراب پہلی بوٹ کے بعد ویری ایبل کو درست کرنے سے کچھ تبدیل نہیں ہوتا۔ ڈیٹا بیس رول کا پاس ورڈ ALTER ROLE کے ساتھ تبدیل کریں تاکہ وہ کنفیگر شدہ پاس ورڈ سے میل کھا سکے؛ db-data والیوم کو ہٹانا صرف ان انسٹالیشنز کے لیے ایک آپشن ہے جو عارضی ہوں اور جن میں کوئی ڈیٹا محفوظ نہ رکھنا ہو۔

لاگ ان کامیاب ہوتا ہے لیکن بورڈ کبھی لوڈ نہیں ہوتا۔ BASE_URL براؤزر بار میں موجود ایڈریس سے میل نہیں کھاتا، اس لیے سرور ساکٹ کے اوریجن (origin) کو مسترد کر دیتا ہے۔ براؤزر کنسول /socket.io/ پر ناکام درخواستیں دکھاتا ہے۔

اپ لوڈز ناکام ہو جاتے ہیں جبکہ باقی سب کچھ کام کرتا ہے۔ ایک بائنڈ ماؤنٹ (bind mount) جس کا مالک root ہے۔ ہوسٹ ڈائریکٹری پر sudo chown -R 1000:1000 چلائیں اور کنٹینر کو دوبارہ شروع کریں۔

اپ گریڈ کے بعد اٹیچمنٹس غائب ہو گئیں۔ /app/data اصل اپ لوڈز والیوم کے ساتھ منسلک نہیں تھا۔ اس والیوم کو دوبارہ منسلک کریں یا بیک اپ سے فائلیں بحال کریں، پھر امیج ٹیگ کو دوبارہ چھونے سے پہلے ایک نامزد والیوم (named volume) استعمال کریں۔

Traefik 404 واپس کرتا ہے۔ درخواست سے کوئی راؤٹر میل نہیں کھایا: Host() رول آپ کے DNS ریکارڈ سے میل نہیں کھاتا، یا لیبلز Traefik تک نہیں پہنچے۔ docker compose config متبادل کے بعد لیبلز دکھاتا ہے، جہاں ٹائپنگ کی غلطیاں واضح ہو جاتی ہیں۔ 502 کا مطلب یہ ہے کہ روٹ میل کھا گیا لیکن کنٹینر تک رسائی حاصل نہیں ہو سکی، لہذا چیک کریں کہ آیا یہ proxy نیٹ ورک پر موجود ہے۔

اطلاعات یا ویب ہکس کبھی نہیں پہنچتے۔ Planka 2 اپنی آؤٹ گوئنگ HTTP درخواستیں ایک داخلی فلٹر کے ذریعے بھیجتا ہے، اور ڈیفالٹ بلاک لسٹ میں localhost اور postgres شامل ہیں۔ localhost پر بھیجا گیا ویب ہک ڈیزائن کے مطابق بلاک کر دیا جاتا ہے، اور ایک بار جب آپ OUTGOING_ALLOWED_HOSTS سیٹ کر لیتے ہیں، تو اس لسٹ میں شامل نہ ہونے والا ہر ہوسٹ بھی بلاک ہو جاتا ہے۔ ویب ہک کو دوسرے کنٹینر کے سروس نام کی طرف پوائنٹ کریں، اور اگر آپ الاؤ لسٹ استعمال کرتے ہیں تو اس نام کو OUTGOING_ALLOWED_HOSTS میں شامل کریں، بجائے اس کے کہ فلٹر کو ہٹا دیں۔

ایک بار جب یہ چلنے لگے تو آپریشنل بوجھ کم ہوتا ہے۔ ریلیز نوٹس پر نظر رکھیں، اور ہر اپ گریڈ سے پہلے ڈیٹا بیس کا ڈمپ لیں۔ ایک ریبوٹ سٹیک کو خود بخود واپس لے آتا ہے کیونکہ restart: unless-stopped موجود ہے، بشرطیکہ Docker سروس خود بوٹ پر فعال ہو، اور وہ Compose سٹیکس جو ریبوٹ کے بعد واپس آ جاتے ہیں ان کیسز کا احاطہ کرتا ہے جہاں ایسا نہیں ہوتا۔

FAQ

لاگ ان کرنے کے بعد Planka لوڈ کیوں ہوتا رہتا ہے؟

اس کی وجہ یہ ہے کہ اسناد (credentials) تو قبول کر لی گئیں لیکن لائیو کنکشن قائم نہیں ہو سکا۔ براؤزر صفحے کے اصل ماخذ (origin) سے ساکٹ کھولتا ہے، جبکہ Planka اپنے مجاز ساکٹ اوریجنز کا تعین BASE_URL سے کرتا ہے۔ لہذا اگر آپ اس متغیر (variable) کو http://localhost:3000 پر چھوڑ دیں جبکہ آپ سائٹ تک https://kanban.example.com کے ذریعے رسائی حاصل کر رہے ہوں، تو سرور کنکشن مسترد کر دے گا۔ ڈویلپر کنسول میں /socket.io/ پر ناکام درخواستیں نظر آئیں گی۔ BASE_URL کو درست عوامی پتے (public address) پر سیٹ کریں جس کے آخر میں سلیش نہ ہو، پھر TRUST_PROXY=true کا اضافہ کریں تاکہ ایپ آپ کے reverse proxy سے آنے والے X-Forwarded-Proto ہیڈر کا احترام کر سکے، اور آخر میں docker compose up -d چلائیں۔

میں پہلا Planka ایڈمن صارف کیسے بناؤں؟

ورژن 1.13 کے بعد سے کوئی ایڈمنسٹریٹر خودکار طور پر نہیں بنتا۔ یا تو DEFAULT_ADMIN_EMAIL کو اس کے متعلقہ پاس ورڈ، نام اور یوزر نیم کے متغیرات کے ساتھ سیٹ کر کے سٹیک شروع کریں، یا docker compose run --rm planka npm run db:create-admin-user چلائیں اور پوچھے گئے سوالات کے جواب دیں۔ ایک شیئرڈ سرور پر انٹرایکٹو کمانڈ زیادہ محفوظ ہے، کیونکہ پاس ورڈ کنٹینر کی کنفیگرڈ انوائرمنٹ میں نہیں جاتا جہاں docker inspect اسے پڑھ سکے۔ سیٹ اپ کے بعد DEFAULT_ADMIN_EMAIL کو سیٹ رکھنے سے اس اکاؤنٹ کے نام، کردار اور ای میل ایڈریس میں تبدیلی رک جاتی ہے، اور انٹرفیس سے اس کے حذف ہونے کا امکان ختم ہو جاتا ہے۔ سیٹ اپ کے بعد DEFAULT_ADMIN_PASSWORD کو ہٹا دیں، کیونکہ اسے سیٹ چھوڑنے سے ہر سٹارٹ اپ پر متعلقہ اکاؤنٹ کا پاس ورڈ ری سیٹ ہو جاتا ہے۔

Planka اٹیچمنٹس اور اوتار کہاں محفوظ کرتا ہے؟

Planka 2 میں تمام اپ لوڈ کردہ فائلیں کنٹینر کے اندر /app/data میں رہتی ہیں، بشمول اٹیچمنٹس، صارف کے اوتار اور بورڈ کے پس منظر۔ اس پاتھ کو ایک named volume پر ماؤنٹ کریں۔ واضح ماؤنٹ کے بغیر، Docker امیج ایک anonymous volume استعمال کرتا ہے، جسے بعد میں docker compose up کرنے پر docker compose down کے بعد خودکار طور پر دوبارہ منسلک نہیں کیا جاتا۔ ایک bind mount بھی کام کرتا ہے، لیکن Node پروسیس UID 1000 کے طور پر چلتا ہے، لہذا ہوسٹ ڈائریکٹری پر sudo chown -R 1000:1000 چلائیں ورنہ اپ لوڈز permission error کی وجہ سے ناکام ہو جائیں گے۔

خود میزبانی (self-hosted) والے Planka کو کتنی RAM درکار ہے؟

پروجیکٹ کی تکنیکی FAQ چھوٹی ٹیموں کے لیے کم از کم 2 GB RAM اور 10 GB سٹوریج تجویز کرتی ہے۔ ڈیفالٹ Docker ڈپلائیمنٹ ایک Node پروسیس، ایک Postgres سرور (جس میں ہر کھلے کنکشن کے لیے ایک بیک اینڈ پروسیس ہوتا ہے)، اور آؤٹ گوئنگ درخواستوں کی فلٹرنگ کے لیے ایک اندرونی Squid پراکسی چلاتی ہے۔ ایک عام ہفتے کے بعد docker stats --no-stream چلائیں اور اپنے اعداد و شمار کے مطابق سائز کا تعین کریں۔ میموری سے زیادہ ڈسک پر نظر رکھیں، کیونکہ اٹیچمنٹس ہی وہ چیز ہے جو بڑھتی ہے۔

میں ڈیٹا ضائع کیے بغیر Planka کو اپ گریڈ کیسے کروں؟

اپ گریڈ سے فوراً پہلے ڈیٹا بیس کا ڈمپ لیں اور اپ لوڈز والیوم کو آرکائیو کریں، نہ کہ پچھلی رات کے شیڈول پر انحصار کریں۔ docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql استعمال کریں، اور ری ڈائریکٹ شدہ آؤٹ پٹ کے لیے pseudo-terminal allocation کو غیر فعال کرنے کے لیے -T کو برقرار رکھیں۔ ہر اس ورژن کے ریلیز نوٹس پڑھیں جسے آپ چھوڑ رہے ہیں، امیج ٹیگ کو latest کے بجائے کسی مخصوص ریلیز پر تبدیل کریں، پھر docker compose pull اور docker compose up -d چلائیں اور مائیگریشن کے لیے لاگ کو مانیٹر کریں۔ Postgres ٹیگ کو اس کے میجر ورژن پر پن (pin) رکھیں، کیونکہ سرور کسی مختلف میجر ورژن سے لکھی گئی ڈیٹا ڈائریکٹری کو کھولنے سے انکار کر دیتا ہے۔

کیا یہ مضمون مفید تھا؟