Docker Compose के साथ Planka को self-host कैसे करें
Docker Compose का उपयोग करके अपने VPS पर Planka को deploy करने का तरीका जानें। इसमें Postgres सेटअप, Traefik कॉन्फ़िगरेशन और BASE_URL से जुड़ी लॉगिन समस्याओं का समाधान शामिल है।
Planka को self-host करने के लाभ
Planka को self-host करने से आपकी टीम को Trello जैसा ही Kanban बोर्ड मिलता है, जिसमें कार्ड, लिस्ट और लेबल का वही मॉडल होता है जिसे लोग पहले से जानते हैं। यह आपके द्वारा नियंत्रित VPS पर चलता है। इसमें कोई seat limit या प्रति-उपयोगकर्ता बिलिंग नहीं है, क्योंकि एकमात्र खर्च सर्वर का है। यह गाइड इसे Traefik के पीछे Docker Compose के साथ deploy करती है, जिसमें डेटा के लिए Postgres और अपलोड की गई प्रत्येक फाइल के लिए एक named volume का उपयोग किया जाता है।
Planka 2 प्रोजेक्ट के अपने Fair Use License के तहत release होता है, जिसे प्रोजेक्ट open source के बजाय source-available बताता है। इसे अपने संगठन के आंतरिक प्रोजेक्ट्स के लिए चलाना मान्य है। इसे तीसरे पक्ष को commercial hosted service के रूप में पेश करने के लिए Pro या Enterprise licence की आवश्यकता होती है।
यह गाइड उन दो से पांच लोगों की टीमों के लिए है जो Trello के free tier से बाहर निकल रहे हैं। यदि आप अभी भी यह तय कर रहे हैं कि कौन सा बोर्ड इस्तेमाल करना है, तो पहले self-hosted Trello विकल्पों की तुलना पढ़ें। यह गाइड मानती है कि आपने चुनाव कर लिया है और केवल deploy करने की प्रक्रिया बताती है।
आपको Docker Engine और Compose plugin चलाने वाले एक VPS की आवश्यकता है, जिस पर एक DNS A record पॉइंट कर रहा हो। आपको उस बॉक्स पर पहले से ही TLS (transport layer security) terminate करने वाले एक Traefik instance की भी आवश्यकता है। यदि Traefik अभी तक वहां नहीं है, तो पहले कई Compose apps के सामने एक Traefik reverse proxy सेट करें, और यदि नीचे दी गई फाइल अपरिचित लगे तो VPS के लिए Docker Compose की बुनियादी बातें पढ़ें।
Planka को कितने VPS की आवश्यकता है?
प्रोजेक्ट के तकनीकी FAQ में छोटी टीमों के लिए कम से कम 2 GB RAM और 10 GB स्टोरेज की सिफारिश की गई है, इसलिए इन आंकड़ों को एक माप के बजाय शुरुआती बिंदु मानें।
वास्तव में जो चलता है वह छोटा है: API और built frontend को serve करने वाली एक Node.js प्रक्रिया, और डेटा रखने वाला एक Postgres सर्वर, जो एक supervising प्रक्रिया और प्रत्येक open connection के लिए एक backend प्रक्रिया चलाता है। Planka container के अंदर outgoing requests को filter करने के लिए एक छोटी proxy प्रक्रिया भी चलती है। 2 GB का प्लान छोटी टीमों के लिए प्रोजेक्ट की RAM सिफारिश से मेल खाता है। एक बोर्ड एक हल्का पड़ोसी है, इसलिए यदि उसी VPS पर आपकी टीम के दस्तावेज़ भी रखने हैं, तो पहले उस ऐप के लिए आकार निर्धारित करें: Notion-style workspace के रूप में AFFiNE चलाना Planka द्वारा कुछ भी मांगने से पहले ही अपने आप में कुछ gigabytes की मांग करता है।
मेमोरी का आकार निर्धारित करने से पहले डिस्क का आकार निर्धारित करें, क्योंकि attachments वह हिस्सा हैं जो बढ़ता है। इस पैराग्राफ पर भरोसा करने के बजाय अपने स्वयं के instance को मापें:
docker stats --no-stream
docker system df -vपहला कमांड प्रति container live मेमोरी और CPU को प्रिंट करता है। दूसरा दिखाता है कि प्रत्येक volume कितनी जगह घेरता है। दोनों रीडिंग एक सामान्य कार्य सप्ताह के बाद लें, न कि install वाले दिन, क्योंकि एक idle बोर्ड आपकी टीम के बारे में कुछ नहीं बताता है।
Compose file लिखें
Directory बनाएँ और उसका स्वामित्व (ownership) प्राप्त करें, ताकि आपको इन फाइलों को कभी भी sudo के माध्यम से edit न करना पड़े।
sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/plankaSecrets को Compose file के बगल में एक .env फाइल में generate करें। Compose उस फाइल को स्वचालित रूप से पढ़ता है और values को 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 .envopenssl rand -hex जानबूझकर चुना गया है। एक hex string में केवल अंक और a से f तक के अक्षर होते हैं, इसलिए यह उस DATABASE_URL connection string को नहीं तोड़ सकता जिसमें इसे paste किया जाता है। Standard Base64 में slash, plus sign और padding equals sign हो सकते हैं, लेकिन कभी भी at sign नहीं होता; connection URL में विशेष अर्थ रखने वाले characters को percent-encoding की आवश्यकता होती है। इसका व्यापक विवरण Compose file से 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 कंटेनर तकproxynetwork के माध्यम से पहुँचता है, इसलिए port 1337 को कभी भी host पर publish नहीं किया जाता है। इसे publish करने से कोई भी आपके proxy और certificate को bypass कर सकता है। loadbalancer.server.port=1337कंटेनर के अंदर के port का नाम बताता है। Planka 1337 पर listen करता है, और upstream उदाहरण केवल 3000 पर उस तक पहुँचता है क्योंकि यह port को host पर map करता है। यहाँ कोई host mapping नहीं है, इसलिए Traefik को कंटेनर port के बारे में बताना पड़ता है।condition: service_healthy, Postgres healthcheck के साथ जुड़ा है। इसके बिना Planka डेटाबेस द्वारा connections स्वीकार करने से पहले ही start हो जाता है, अपनी पहली query में विफल हो जाता है और exit कर जाता है, जो एक crash loop जैसा दिखता है। इसकी कार्यप्रणाली Compose healthchecks और startup ordering में दी गई है।- डेटाबेस service का नाम जानबूझकर
postgresरखा गया है। Planka 2 अपनी outgoing requests को एक internal filter के माध्यम से भेजता है जिसकी default block listlocalhost,postgresहै। service का नाम बदलने पर आप चुपचाप अपने डेटाबेस को उस सूची से हटा देते हैं।
कुछ भी शुरू करने से पहले जाँच लें कि Compose आपके secrets को देख पा रहा है या नहीं:
docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'यह उस फाइल को print करता है जिसमें .env values पहले से ही substitute हो चुकी हैं। एक खाली value का मतलब है कि Compose .env फाइल को नहीं पढ़ पा रहा है, आमतौर पर ऐसा इसलिए होता है क्योंकि आप किसी दूसरी directory से command चला रहे हैं।
एडमिन बूटस्ट्रैप वेरिएबल्स वास्तव में क्या करते हैं
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 तक, कम्युनिटी एडिशन लॉग इन को OIDC प्रोवाइडर जैसे कि अपने स्वयं के सिंगल साइन-ऑन सर्वर के रूप में चलने वाले Authentik को सौंप सकता था, लेकिन अगस्त 2026 में जारी वर्जन 2.2.0 ने OIDC और SSO को PLANKA Pro में स्थानांतरित कर दिया। उसी रिलीज में कम्युनिटी एडिशन को जो मिला, वह लोकल अकाउंट्स के लिए टू-फैक्टर ऑथेंटिकेशन (TOTP) है, इसलिए कम से कम एडमिन अकाउंट के लिए इसे चालू रखें।
BASE_URL मेल न खाने पर लॉगिन क्यों विफल हो जाता है
BASE_URL वह सटीक पता है जिसे उपयोगकर्ता ब्राउज़र में टाइप करते हैं, जिसमें scheme शामिल होती है और अंत में कोई स्लैश नहीं होता है। इस स्टैक के लिए यह https://kanban.example.com है। Planka इस मान से अपने लिंक और स्वीकृत WebSocket origins की सूची बनाता है, जिसका अर्थ है कि गलत BASE_URL होने पर आपको कोई स्पष्ट त्रुटि नहीं मिलती है। इसके बजाय, आपको एक ऐसा पेज मिलता है जो लोड तो होता है, लेकिन कभी पूरा लोड नहीं हो पाता।
सामान्य स्थिति यह है: आप upstream उदाहरण को कॉपी करते हैं, BASE_URL=http://localhost:3000 को वैसे ही छोड़ देते हैं, और अपने वास्तविक डोमेन पर HTTPS के माध्यम से साइट तक पहुँचते हैं। लॉगिन फॉर्म सबमिट हो जाता है और आपके क्रेडेंशियल्स स्वीकार कर लिए जाते हैं। लेकिन बोर्ड कभी दिखाई नहीं देता। ब्राउज़र डेवलपर कंसोल खोलें और आप देखेंगे कि /socket.io/ के लिए अनुरोध विफल हो रहे हैं, क्योंकि सॉकेट ब्राउज़र पेज के origin से जुड़ता है, लेकिन सर्वर का origin प्रतिबंध BASE_URL से प्राप्त origin की ही अनुमति देता है।
TRUST_PROXY=true इसी समस्या का दूसरा हिस्सा है। Planka, Traefik के पीछे स्थित है, इसलिए प्रत्येक अनुरोध Docker नेटवर्क के भीतर plain HTTP पर प्रॉक्सी के पते से उस तक पहुँचता है। 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" को फॉरवर्ड करना पड़ता है, अन्यथा आपको एक अलग कारण से वही फंसा हुआ स्पिनर दिखाई देगा। इन्हें सामान्य location / ब्लॉक में रखा जा सकता है; /socket.io के लिए एक अलग ब्लॉक भी काम करता है लेकिन यह आवश्यक नहीं है।
बोर्ड को बाद में किसी नए होस्टनेम पर ले जाने का मतलब है दो चीजों को एक साथ बदलना: BASE_URL मान और Traefik Host() नियम। एक को बदलें और दूसरे को भूल जाएं, तो आप वापस उसी स्पिनर पर आ जाएंगे। Planka को https://example.com/planka जैसे सबपाथ से सर्व करना संस्करण 2.1.0 के बाद से काम करता है, जिसे मार्च 2026 में रिलीज़ किया गया था। पुराने टैग्स पर, इसे अपना एक अलग सबडोमेन दें।
Planka अटैचमेंट और अवतार कहाँ रखता है
Planka 2 उपयोगकर्ता द्वारा अपलोड की गई हर चीज़ को कंटेनर के अंदर एक ही पाथ में स्टोर करता है: /app/data। अटैचमेंट, उपयोगकर्ता अवतार और बोर्ड बैकग्राउंड इमेज सभी इसी के अंदर रहते हैं। वर्शन 1 में तीन अलग-अलग डायरेक्टरी का उपयोग होता था, इसलिए पुराने लेख से कॉपी की गई Compose फाइल उन पाथ को माउंट करती है जो अब मौजूद नहीं हैं, और वांछित डेटा माउंट गायब हो जाता है।
वह एक सिंगल माउंट ही तय करता है कि अपग्रेड के बाद आपका बोर्ड सुरक्षित रहेगा या आपको परेशानी होगी। Docker इमेज /app/data को एक वॉल्यूम के रूप में घोषित करती है, इसलिए Compose से माउंट को हटाने पर अपलोड एक एनोनिमस वॉल्यूम में चले जाते हैं। Compose सामान्य up रिक्रिएशन के दौरान इसे सुरक्षित रखता है, लेकिन बाद में किया गया down और उसके बाद up इसे स्वचालित रूप से फिर से कनेक्ट नहीं करता है। बोर्ड वापस आने पर ठीक दिखता है, कार्ड्स वहीं होते हैं, लेकिन हर अटैचमेंट लिंक काम करना बंद कर देता है, क्योंकि डेटाबेस रो अभी भी पुराने वॉल्यूम की फाइलों की ओर इशारा कर रही होती हैं।
ऊपर दी गई Compose फाइल में नामित वॉल्यूम (named volume) इस समस्या को रोकता है। एक बाइंड माउंट (bind mount) भी काम करता है और सामान्य टूल्स के साथ फाइलों का बैकअप लेना आसान बनाता है, लेकिन इसके लिए एक अतिरिक्त कदम की आवश्यकता होती है। कंटेनर के अंदर Node प्रोसेस UID 1000 के रूप में चलती है, इसलिए root के स्वामित्व वाली होस्ट डायरेक्टरी पहले अपलोड पर ही परमिशन एरर देती है:
sudo chown -R 1000:1000 /opt/planka/dataइन दोनों के बीच के अंतर को बाइंड माउंट बनाम नामित वॉल्यूम में समझाया गया है।
यदि आपके प्लान में अटैचमेंट डिस्क की क्षमता से अधिक हो जाते हैं, तो Planka उन्हें S3_ENDPOINT, S3_BUCKET और संबंधित की-वेरिएबल्स के माध्यम से S3-संगत स्टोरेज में लिख सकता है। यह किसी होस्टेड बकेट या किसी अन्य बॉक्स पर सेल्फ-होस्टेड MinIO ऑब्जेक्ट स्टोर की ओर इशारा कर सकता है। टीम द्वारा बोर्ड भरने से पहले ही इसका निर्णय ले लें, क्योंकि S3 को इनेबल करने पर फाइल रीड और राइट उस बैकएंड पर स्विच हो जाते हैं, लेकिन मौजूदा अपलोड माइग्रेट नहीं होते हैं।
स्टैक को स्टार्ट करें और जाँचें कि यह काम कर रहा है
docker compose pull
docker compose up -d
docker compose psdocker compose ps को postgres को healthy के रूप में और planka को running के रूप में दिखाना चाहिए। यदि Planka एक लूप में रीस्टार्ट हो रहा है, तो सबसे पहले डेटाबेस कनेक्शन की जाँच करें, न कि ऐप की।
docker compose logs -f plankaएक सफल फर्स्ट बूट डेटाबेस माइग्रेशन चलाता है, लेकिन प्रोडक्शन कॉन्फ़िगरेशन noShip: true को सेट करता है और उस स्टार्टअप संदेश को दबा देता है जो पोर्ट 1337 की रिपोर्ट करता है। लॉग पर भरोसा करने के बजाय सीधे Postgres से पूछकर पुष्टि करें कि स्कीमा वास्तव में लोड हुआ है या नहीं:
docker compose exec postgres psql -U planka -d planka -c '\dt'टेबल सूची में board और card का होना यह दर्शाता है कि माइग्रेशन चल गए हैं। "Did not find any relations" का मतलब है कि Planka कभी कनेक्ट नहीं हुआ, इसलिए DATABASE_URL की तुलना अपने .env में मौजूद POSTGRES_USER और POSTGRES_PASSWORD मानों से करें।
फिर अपने VPS से नहीं, बल्कि अपनी मशीन से रूट की जाँच करें:
curl -I https://kanban.example.comHTTP/2 200 का मतलब है कि Traefik के पास सर्टिफिकेट है और वह कंटेनर तक पहुँच रहा है। Traefik द्वारा दिया गया 404 एरर मतलब है कि कोई राउटर अनुरोध से मेल नहीं खाता: Host() नियम आपके द्वारा मांगे गए होस्टनेम से मेल नहीं खाता है, या Traefik ने लेबल को पिक नहीं किया है। 502 का मतलब है कि राउटर मेल खा गया लेकिन Traefik कंटेनर तक नहीं पहुँच सका, उदाहरण के लिए क्योंकि यह proxy नेटवर्क से जुड़ा नहीं है। अब साइट खोलें और एडमिन अकाउंट से लॉग इन करें।
हर 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 के डिफ़ॉल्ट स्यूडो-टर्मिनल एलोकेशन को अक्षम कर देता है, जिससे डंप एक प्लेन आउटपुट स्ट्रीम पर बना रहता है।
इसके बाद अपलोड्स का बैकअप लें। पहले वास्तविक वॉल्यूम नाम का पता लगाएँ, क्योंकि 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 भी प्रदान करता है, और आधिकारिक दस्तावेज़ इन्हें nightly cron job पर चलाने का सुझाव देते हैं। दोनों में से कोई भी तरीका सही है। जो तरीका सही नहीं है, वह है ऐसा बैकअप जिसे आपने कभी रिस्टोर करके नहीं देखा। इसलिए, एक बार किसी स्क्रैच VPS पर बैकअप रिस्टोर करें और पुष्टि करें कि आप लॉग इन कर सकते हैं और अटैचमेंट खोल सकते हैं। यही दो स्टोरेज स्थान हर उस Compose ऐप में होते हैं जो अपलोड स्वीकार करते हैं, इसलिए यदि आप बाद में Chatwoot को अपने सपोर्ट डेस्क वाले सर्वर पर डालते हैं, तो यहाँ बनाई गई प्रक्रिया केवल वॉल्यूम नाम बदलकर आसानी से लागू की जा सकती है।
हर version change से ठीक पहले डंप चलाएँ। पिछली रात का बैकअप उस बैकअप के समान नहीं है जो माइग्रेशन शुरू करने से ठीक पहले लिया गया हो।
टैग को पिन करें और रिलीज़ नोट्स पढ़ें
उस फ़ाइल में दोनों इमेज टैग जानबूझकर पिन किए गए हैं।
ghcr.io/plankanban/planka:2.2.1 एक विशिष्ट रिलीज़ है, जो अक्टूबर 2026 तक करंट है। Community 2.3.0 को 4 नवंबर, 2026 को सुरक्षा सुधारों के साथ रिलीज़ किया गया था, और अपस्ट्रीम इसे अपडेट करने की सलाह देता है। Community 2.3.1 इसके बाद 5 नवंबर, 2026 को आया, जिसने उन बोर्डों पर कार्ड विवरण संपादित करते समय क्रैश को ठीक किया जहाँ किसी सदस्य का कोई यूज़रनेम नहीं था। latest तब बदल जाता है जब भी अपस्ट्रीम पब्लिश करता है, इसलिए एक रूटीन docker compose pull ऐसे समय में स्कीमा माइग्रेशन ला सकता है जिसे आपने नहीं चुना है। उस नंबर को बदलने से पहले रिलीज़ नोट्स पढ़ें, क्योंकि वहीं ब्रेकिंग बदलावों और सुरक्षा सुधारों का वर्णन होता है। वर्शन 2.0.3 को एक सुरक्षा रिलीज़ के रूप में पब्लिश किया गया था, जो बिल्कुल वैसी ही चीज़ है जिसे आप गलती से अपनाने के बजाय पढ़ना चाहेंगे। अगस्त 2026 में रिलीज़ हुआ 2.2.1 भी ऐसा ही था: यह एक पाथ ट्रैवर्सल खामी को ठीक करता है जो एक लॉग-इन यूज़र को लोकल फ़ाइल स्टोरेज का उपयोग करने वाले इंस्टेंस पर मनमानी फ़ाइलें पढ़ने की अनुमति देता था, जो इस गाइड में सेटअप है, और एडवाइजरी 2.1.1 और उससे पहले के वर्शन को प्रभावित बताती है। यदि आप 2.1.x से आ रहे हैं, तो पहले 2.2.0 के नोट्स पढ़ें, क्योंकि वह रिलीज़ उन यूज़र्स को डीएक्टिवेट कर देती है जिन्होंने केवल SSO के माध्यम से साइन इन किया था, जब तक कि एडमिन उन्हें पासवर्ड न दे और उन्हें फिर से सक्रिय न करे। यहाँ पिनिंग आसान है क्योंकि अपस्ट्रीम इमेज पब्लिश करता है, और जहाँ कोई प्रोजेक्ट कुछ भी शिप नहीं करता, वहाँ आपको चेक-आउट किए गए git टैग से बॉक्स पर बने openGym की तरह अतिरिक्त सावधानी बरतनी चाहिए।
postgres:16-alpine को एक कठिन कारण से मेजर वर्शन पर पिन किया गया है। Postgres अपनी डेटा डायरेक्टरी को एक ऐसे फॉर्मेट में लिखता है जो मेजर वर्शन से जुड़ा होता है, और सर्वर किसी अलग वर्शन द्वारा लिखी गई डायरेक्टरी को खोलने से इनकार कर देता है। postgres:latest लिखें, टैग को 16 से आगे बढ़ने दें, और कंटेनर स्टार्ट नहीं होगा। उदाहरण के लिए, 17 इमेज इस एरर के साथ रुक जाती है:
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.कुछ भी खोया नहीं है, और रीस्टार्ट करने से कुछ भी ठीक नहीं होता है। नए Postgres मेजर पर जाने का मतलब है पुराने वर्शन से डंप लेना और नए पर एक ताज़ा डेटा डायरेक्टरी में रिस्टोर करना, एक pg_upgrade रन, जो डंप के बिना डेटा को कन्वर्ट करता है लेकिन इसके लिए पुराने और नए सर्वर बाइनरी को एक साथ उपलब्ध होना चाहिए, या नए वर्शन पर चल रहे सर्वर के लिए लॉजिकल रेप्लिकेशन और उसके बाद स्विचओवर की आवश्यकता होती है। प्रत्येक रास्ता एक नियोजित माइग्रेशन है, न कि इमेज पुल का साइड इफेक्ट; लॉजिकल रेप्लिकेशन पुराने सर्वर को चलते रहने देता है जबकि नया सर्वर डेटा सिंक कर लेता है।
यदि आप नए सिरे से शुरुआत करने के बजाय मौजूदा Planka 1.x इंस्टाल को मूव कर रहे हैं, तो उस अपग्रेड की प्रोजेक्ट डॉक्यूमेंटेशन में अपनी प्रक्रिया है, और पहले से लिए गए बैकअप के बिना वर्शन 1 पर वापस जाने का कोई रास्ता नहीं है।
विफलता के प्रकार और दिखाई देने वाले संदेश
Planka लूप में रीस्टार्ट होता है और लॉग में डेटाबेस का नाम आता है। DATABASE_URL में दिए गए क्रेडेंशियल्स Postgres एनवायरनमेंट से मेल नहीं खाते हैं। ध्यान दें कि POSTGRES_PASSWORD केवल तभी लागू होता है जब डेटा डायरेक्टरी पहली बार इनिशियलाइज़ की जाती है, इसलिए खराब फर्स्ट बूट के बाद वेरिएबल को ठीक करने से कुछ नहीं बदलता। डेटाबेस रोल का पासवर्ड ALTER ROLE के साथ कॉन्फ़िगर किए गए पासवर्ड से मेल खाने के लिए बदलें; db-data वॉल्यूम को हटाना केवल उन इंस्टॉलेशन के लिए एक विकल्प है जिन्हें हटाया जा सकता है और जिसमें कोई डेटा सुरक्षित नहीं रखना है।
लॉगिन सफल होता है लेकिन बोर्ड कभी लोड नहीं होता। BASE_URL ब्राउज़र बार में दिए गए पते से मेल नहीं खाता है, इसलिए सर्वर सॉकेट के ओरिजिन को अस्वीकार कर देता है। ब्राउज़र कंसोल /socket.io/ पर विफल अनुरोध दिखाता है।
बाकी सब कुछ काम करता है लेकिन अपलोड विफल हो जाते हैं। एक बाइंड माउंट का मालिक root है। होस्ट डायरेक्टरी पर sudo chown -R 1000:1000 चलाएं और कंटेनर को रीस्टार्ट करें।
अपग्रेड के बाद अटैचमेंट गायब हो गए। /app/data को मूल अपलोड वॉल्यूम से अटैच नहीं किया गया था। उस वॉल्यूम को फिर से अटैच करें या बैकअप से फाइलें रिस्टोर करें, फिर इमेज टैग को दोबारा बदलने से पहले एक नेम्ड वॉल्यूम का उपयोग करें।
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 हमेशा लोड क्यों होता रहता है?
क्रेडेंशियल्स स्वीकार कर लिए गए थे लेकिन लाइव कनेक्शन नहीं हुआ। ब्राउज़र पेज के ऑरिजिन पर अपना सॉकेट खोलता है, जबकि Planka अपने अनुमत सॉकेट ऑरिजिन को BASE_URL से प्राप्त करता है। इसलिए, यदि आप उस वेरिएबल को http://localhost:3000 पर छोड़ देते हैं जबकि आप साइट को https://kanban.example.com पर एक्सेस कर रहे हैं, तो सर्वर कनेक्शन को अस्वीकार कर देता है। डेवलपर कंसोल /socket.io/ पर विफल अनुरोधों को दिखाता है। BASE_URL को बिना किसी ट्रेलिंग स्लैश के सटीक सार्वजनिक पते पर सेट करें, 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 down के बाद अगला docker compose up स्वचालित रूप से फिर से कनेक्ट नहीं करता है। एक 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 एलोकेशन को अक्षम करने के लिए -T को बनाए रखें। आपके द्वारा छोड़े गए प्रत्येक वर्जन के लिए रिलीज़ नोट्स पढ़ें, इमेज टैग को latest के बजाय एक विशिष्ट रिलीज़ में बदलें, फिर docker compose pull और docker compose up -d चलाएं और माइग्रेशन के लिए लॉग पर नज़र रखें। Postgres टैग को उसके मेजर वर्जन पर पिन रखें, क्योंकि सर्वर किसी भिन्न मेजर वर्जन द्वारा लिखे गए डेटा डायरेक्टरी को खोलने से इनकार कर देता है।