Planka Kanban बोर्ड Docker Compose वर कसे होस्ट करावे
Docker Compose वापरून Planka तैनात करण्याची संपूर्ण पद्धत जाणून घ्या. Postgres आणि Traefik सेटअपसह BASE_URL मधील त्रुटी आणि ॲडमिन बूटस्ट्रॅप व्हेरिएबल्सची माहिती येथे दिली आहे.
Planka self-host केल्याने तुम्हाला काय मिळते
Planka self-host केल्यामुळे तुमच्या टीमला Trello प्रमाणेच कार्ड, लिस्ट आणि लेबल मॉडेल असलेले Kanban बोर्ड मिळते, जे तुमच्या नियंत्रणाखाली असलेल्या VPS वर चालते. यामध्ये वापरकर्त्यांच्या संख्येवर कोणतीही मर्यादा नाही आणि प्रति-वापरकर्ता बिलिंगही नाही, कारण सर्व्हरचा खर्च हाच एकमेव खर्च आहे. हे मार्गदर्शक Traefik च्या मागे Docker Compose वापरून Planka तैनात करते, ज्यामध्ये डेटासाठी Postgres आणि वापरकर्त्यांनी अपलोड केलेल्या प्रत्येक फाईलसाठी एक named volume वापरला जातो.
Planka 2 हे प्रकल्पाच्या स्वतःच्या Fair Use License अंतर्गत रिलीज केले जाते, ज्याला प्रकल्प 'ओपन सोर्स' ऐवजी 'सोर्स-अवेलेबल' (source-available) असे संबोधतो. तुमच्या संस्थेच्या अंतर्गत प्रकल्पांसाठी ते चालवण्यास परवानगी आहे. जर तुम्हाला ते तिसऱ्या पक्षांना व्यावसायिक होस्टेड सेवा म्हणून द्यायचे असेल, तर त्यासाठी Pro किंवा Enterprise लायसन्सची आवश्यकता असते.
हे मार्गदर्शक अशा टीमसाठी आहे ज्यामध्ये दोन ते पाच सदस्य आहेत आणि ज्या Trello च्या फ्री टियरमधून बाहेर पडत आहेत. जर तुम्ही अजूनही कोणता बोर्ड वापरायचा हे ठरवत असाल, तर आधी self-hosted Trello पर्यायांची तुलना वाचा. हे मार्गदर्शक असे गृहीत धरते की तुम्ही निर्णय घेतला आहे आणि ते फक्त डिप्लॉयमेंटवर लक्ष केंद्रित करते.
तुम्हाला Docker Engine आणि Compose प्लगइन असलेला VPS आणि त्यावर पॉइंट करणारा DNS A record आवश्यक आहे. तसेच, त्या बॉक्सवर आधीपासून TLS (transport layer security) टर्मिनेट करणारी Traefik ची एक इन्स्टन्स असणे आवश्यक आहे. जर Traefik आधीच सेट नसेल, तर आधी अनेक Compose अॅप्सच्या पुढे Traefik reverse proxy सेट करा आणि जर खालील फाईल तुम्हाला नवीन वाटत असेल, तर Docker Compose च्या मूलभूत गोष्टी वाचा.
Planka ला किती VPS आवश्यक आहे?
प्रकल्पाच्या तांत्रिक FAQ मध्ये लहान टीमसाठी किमान 2 GB RAM आणि 10 GB storage ची शिफारस केली आहे. त्यामुळे या आकड्यांकडे अचूक मोजमाप म्हणून नव्हे, तर सुरुवातीचा आधार म्हणून पाहा.
प्रत्यक्षात चालणारे घटक लहान आहेत: API आणि build केलेला frontend पुरवणारी एक Node.js प्रक्रिया, तसेच डेटा साठवणारा Postgres server. Postgres एक supervising process आणि प्रत्येक उघड्या connection साठी एक backend process चालवतो. Planka container मध्ये त्याच्या बाहेर जाणाऱ्या requests filter करण्यासाठी एक लहान proxy process देखील चालतो. लहान टीमसाठी 2 GB plan प्रकल्पाच्या RAM शिफारशीशी जुळतो. Board साठी कमी संसाधने लागतात. त्यामुळे त्याच VPS वर तुमच्या टीमची documents देखील ठेवायची असल्यास, आधी त्या अॅपसाठी आवश्यक आकार ठरवा: Notion-style workspace म्हणून AFFiNE चालवण्यासाठी Planka कडून काही मागणी होण्यापूर्वीच स्वतःसाठी काही gigabytes आवश्यक असतात.
Memory चा आकार ठरवण्यापूर्वी disk चा आकार ठरवा, कारण attachments सर्वाधिक वाढतात. या परिच्छेदावर अवलंबून न राहता तुमच्या स्वतःच्या instance चे मोजमाप करा:
docker stats --no-stream
docker system df -vपहिल्या command मुळे प्रत्येक container साठी सध्याचा memory आणि CPU वापर दिसतो. दुसऱ्या command मुळे प्रत्येक volume मध्ये किती जागा वापरली आहे ते दिसते. दोन्ही मोजमाप नेहमीच्या कामकाजाच्या एका आठवड्यानंतर घ्या, install केल्यानंतर लगेच नाही. निष्क्रिय board तुमच्या टीमच्या वापराबद्दल काहीच सांगत नाही.
Compose फाइल लिहा
डिरेक्टरी तयार करून तिचे मालकत्व घ्या. त्यामुळे या फाइल्स sudo द्वारे संपादित करण्याची गरज पडणार नाही.
sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/plankaCompose फाइलच्या बाजूला असलेल्या .env फाइलमध्ये secrets तयार करा. 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 .envopenssl rand -hex हे जाणीवपूर्वक केले आहे. Hex string मध्ये फक्त digits आणि a ते f ही अक्षरे असतात. त्यामुळे ती ज्या DATABASE_URL connection string मध्ये paste केली जाते, ती बिघडू शकत नाही. Standard Base64 मध्ये slash, plus sign आणि padding equals sign असू शकतात; मात्र at sign कधीही नसतो. Connection URL मध्ये विशेष अर्थ असलेल्या characters साठी percent-encoding आवश्यक असते. हा व्यापक pattern 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 नाही. Traefikproxynetwork द्वारे container पर्यंत पोहोचतो. त्यामुळे port 1337 host वर publish होत नाही. तो publish केल्यास तुमच्या proxy आणि certificate ला वगळून प्रवेश करण्याचा मार्ग कोणालाही मिळेल. loadbalancer.server.port=1337container मधील portचे नाव देतो. Planka 1337 वर listen करते. Upstream example मध्ये port host वर map केल्यामुळे ते Planka पर्यंत फक्त 3000 वर पोहोचते. येथे host mapping नाही. त्यामुळे Traefik ला container port सांगणे आवश्यक आहे.condition: service_healthyPostgres healthcheck सोबत काम करते. हे नसल्यास database connections स्वीकारण्यापूर्वी Planka सुरू होते, तिची पहिली query अयशस्वी होते आणि ती बंद होते. त्यामुळे crash loop असल्यासारखे दिसते. याची कार्यपद्धती Compose healthchecks आणि startup ordering येथे दिली आहे.- Database serviceचे नाव जाणीवपूर्वक
postgresठेवले आहे. Planka 2 स्वतःच्या outgoing requests एका internal filterमधून पाठवते. त्या filterची default block listlocalhost,postgresआहे. Serviceचे नाव बदलल्यास तुमचा database त्या listमधून शांतपणे काढला जातो.
काहीही सुरू करण्यापूर्वी Compose तुमचे secrets पाहू शकते का ते तपासा:
docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'यामुळे .env values आधीच substituted असलेली फाइल print होते. रिकामे value दिसल्यास Compose .env फाइल वाचत नाही. सामान्यतः command वेगळ्या directoryमधून चालवला जात असल्यामुळे असे होते.
बूटस्ट्रॅपमधील admin variables प्रत्यक्षात काय करतात
Planka 1.13 पासून administrator आपोआप तयार केला जात नाही. त्यामुळे नवीन database मध्ये login करू शकणारा कोणीही वापरकर्ता नसतो. DEFAULT_ADMIN_* group हा तो प्रश्न सोडवण्याच्या दोन पद्धतींपैकी एक आहे.
सुरू होताना Planka DEFAULT_ADMIN_EMAIL शी जुळणारा user शोधते. असा user नसल्यास, त्याच्यासोबत सेट केलेला password, display name आणि username वापरून Planka तो तयार करते. पुढील startup वेळीही या variables मधून जुळणाऱ्या 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 इतर कोणत्याही account प्रमाणे edit करता येणारा सामान्य admin बनतो.
Password ची line काळजीपूर्वक हाताळा. environment: अंतर्गत असलेली कोणतीही माहिती container वर docker inspect चालवू शकणाऱ्या कोणालाही वाचता येते. त्यामुळे DEFAULT_ADMIN_PASSWORD तिथे कायम ठेवू नये. Login करा, ती line delete करा, पुन्हा docker compose up -d चालवा आणि नंतर interface मध्ये password बदला.
यापेक्षा स्वच्छ पद्धतीत variables पूर्णपणे वगळले जातात. संपूर्ण DEFAULT_ADMIN_* group comment out करा आणि नंतर account परस्परसंवादी पद्धतीने तयार करा:
docker compose run --rm planka npm run db:create-admin-userयामध्ये email, password, display name आणि optional username विचारले जाते. त्यानंतर user थेट database मध्ये लिहिला जातो. Password Compose file किंवा container च्या configured environment मध्ये कधीही जात नाही. VPS वर shell access असलेली एकापेक्षा जास्त व्यक्ती असल्यास ही पद्धत वापरा. depends_on मुळे command आधी Postgres सुरू करते. त्यामुळे यापूर्वी stack कधीही सुरू केलेला नसला तरी ही पद्धत कार्य करते.
दोन्ही पद्धतींमध्ये Planka passwords स्वतः व्यवस्थापित करावे लागतात. Version 2.1.1 पर्यंत Community edition मध्ये तुमचा स्वतःचा single sign-on server म्हणून चालणाऱ्या Authentik सारख्या OIDC provider कडे logins सोपवता येत होते. मात्र August 2026 मध्ये released version 2.2.0 पासून OIDC आणि SSO हे PLANKA Pro मध्ये हलवण्यात आले. त्याच release मध्ये Community edition ला local accounts साठी two-factor authentication (TOTP) मिळाले. त्यामुळे किमान admin account साठी ते सुरू करा.
hostname शी जुळत नसल्यास BASE_URL मुळे login का अयशस्वी होतो
BASE_URL हा browser मध्ये वापरकर्ते scheme सह आणि शेवटी slash न लावता टाइप करतात तो अचूक पत्ता आहे. या stack साठी तो https://kanban.example.com आहे. Planka स्वतःचे links आणि allowed WebSocket origins ची यादी त्या value वरून तयार करते. त्यामुळे चुकीचे BASE_URL असल्यास स्पष्ट error दिसत नाही. Page load होते, पण loading कधीच पूर्ण होत नाही.
सामान्य परिस्थिती अशी असते: upstream example copy केला जातो, BASE_URL=http://localhost:3000 तसेच ठेवले जाते आणि site वर खऱ्या domain द्वारे HTTPS वापरून प्रवेश केला जातो. Login form submit होते आणि credentials स्वीकारली जातात. मात्र board दिसत नाही. Browser developer console उघडल्यावर /socket.io/ कडे केलेल्या requests अयशस्वी झालेल्या दिसतात. कारण 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 headers दुर्लक्षित करते. त्यामुळे connection असुरक्षित आहे असे app ला वाटते आणि प्रत्येक client साठी एकच shared IP address वापरला जातो. TRUST_PROXY सेट केल्यावर app हे headers वाचते आणि scheme बाबत browser शी सुसंगत राहते.
Traefik WebSockets साठी अतिरिक्त configuration शिवाय proxying करते. त्यामुळे या ठिकाणी Traefik निवडणे योग्य ठरते. nginx मध्ये proxy ने upgrade headers, proxy_set_header Upgrade $http_upgrade आणि proxy_set_header Connection "upgrade" forward करणे आवश्यक असते. ते न केल्यास वेगळ्या कारणामुळे तोच stuck spinner दिसतो. हे headers सामान्य location / block मध्ये ठेवता येतात. /socket.io साठी स्वतंत्र block देखील चालतो, पण तो आवश्यक नाही.
नंतर board नवीन hostname वर हलवायचा असल्यास दोन गोष्टी एकत्र बदलणे आवश्यक आहे: BASE_URL value आणि Traefik Host() rule. एक बदलून दुसरा विसरल्यास पुन्हा तोच spinner दिसेल. https://example.com/planka सारख्या subpath वरून Planka serve करणे version 2.1.0 पासून समर्थित आहे; ही आवृत्ती March 2026 मध्ये released झाली. जुन्या tags साठी Planka ला स्वतंत्र subdomain द्या.
Planka मध्ये attachments आणि avatars कुठे साठवले जातात
Planka 2 वापरकर्ता upload करत असलेल्या सर्व फाइल्स कंटेनरमधील एका path अंतर्गत साठवते: /app/data. Attachments, user avatars आणि board background images या सर्व त्याखालीच असतात. Version 1 मध्ये तीन स्वतंत्र directories वापरल्या जात होत्या. त्यामुळे जुन्या write-up मधून कॉपी केलेल्या Compose file मध्ये आता अस्तित्वात नसलेले paths mount होतात आणि अपेक्षित data mount उपलब्ध राहत नाही.
हा mount upgrade नंतर टिकणारा board आणि मोठी अडचण यांमधील मुख्य फरक ठरतो. Docker image /app/data ला volume म्हणून घोषित करते. त्यामुळे Compose मधून हा mount वगळल्यास uploads anonymous volume मध्ये साठवले जातात. साध्या up recreation दरम्यान Compose तो volume जतन करते. परंतु नंतर down करून त्यानंतर up केल्यास तो volume आपोआप पुन्हा जोडला जात नाही. Board व्यवस्थित दिसतो, सर्व cards तिथे असतात; परंतु प्रत्येक attachment link निष्क्रिय असतो, कारण database rows अजूनही जुन्या volume मधील files कडे निर्देश करत असतात.
वरील Compose file मधील named volume ही समस्या टाळतो. Bind mount देखील वापरता येतो आणि सामान्य tools वापरून files चा backup घेणे सोपे होते. परंतु त्यासाठी एक अतिरिक्त पायरी आवश्यक आहे. कंटेनरमधील Node process UID 1000 म्हणून चालतो. त्यामुळे root च्या मालकीची host directory वापरल्यास पहिल्या upload वेळी permission error येतो:
sudo chown -R 1000:1000 /opt/planka/dataया दोन पर्यायांमधील फरक bind mounts आणि named volumes यांची तुलना येथे स्पष्ट केला आहे.
तुमच्या plan मधील disk ची क्षमता attachments साठी अपुरी पडत असल्यास, Planka त्यांना S3-compatible storage मध्येही लिहू शकते. यासाठी S3_ENDPOINT, S3_BUCKET आणि संबंधित key variables वापरले जातात. हे hosted bucket कडे किंवा दुसऱ्या मशीनवरील self-hosted MinIO object store कडे निर्देश करू शकते. टीमने board भरून टाकण्यापूर्वी हा निर्णय घ्या, कारण S3 enable केल्यावर विद्यमान uploads migrate न करता file reads आणि writes त्या backend कडे वळवल्या जातात.
स्टॅक सुरू करा आणि तो व्यवस्थित चालला आहे का ते तपासा
docker compose pull
docker compose up -d
docker compose psdocker compose ps मध्ये postgres हे healthy म्हणून आणि planka हे running म्हणून दिसले पाहिजे. Planka सतत restart होत असेल, तर अॅपकडे पाहण्यापूर्वी database connection तपासा.
docker compose logs -f plankaपहिल्या यशस्वी boot वेळी database migrations चालतात. मात्र production configuration मध्ये noShip: true सेट केलेले आहे आणि port 1337 दर्शवणारा startup message दडपला जातो. 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 database शी connect झालेले नाही. त्यामुळे तुमच्या .env मधील DATABASE_URL ची तुलना POSTGRES_USER आणि POSTGRES_PASSWORD मधील values शी करा.
यानंतर route तुमच्या स्वतःच्या मशीनवरून तपासा; VPS वरून नाही:
curl -I https://kanban.example.comHTTP/2 200 याचा अर्थ Traefik कडे certificate आहे आणि तो container पर्यंत पोहोचत आहे. Traefik ने दिलेला 404 म्हणजे कोणत्याही router ने request match केलेली नाही. तुम्ही विचारलेला hostname Host() rule शी जुळत नाही किंवा Traefik ने labels घेतलेले नाहीत. 502 म्हणजे router ने match केले, पण Traefik container पर्यंत पोहोचू शकला नाही. उदाहरणार्थ, container proxy network शी जोडलेला नसू शकतो. आता site उघडा आणि admin account ने log in करा.
प्रत्येक 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 चे नाव शोधा, कारण Compose त्यापुढे project directory चे नाव जोडते.
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 देखील दिलेले आहेत. अधिकृत documentation मध्ये ते nightly cron job वर चालवण्याची सूचना आहे. दोन्हीपैकी कोणताही मार्ग योग्य आहे. मात्र restore करून न पाहिलेला backup योग्य नाही. त्यामुळे एकदा तो scratch VPS वर restore करा आणि तुम्ही login करू शकता तसेच attachment उघडू शकता याची खात्री करा. uploads स्वीकारणाऱ्या प्रत्येक Compose app मध्ये हेच दोन store असतात. त्यामुळे पुढे तुम्ही तुमच्या support desk सोबत त्याच box वर Chatwoot ठेवले, तरी volume ची नावे बदलण्यापलीकडे ही पद्धत जवळपास तशीच वापरता येईल.
प्रत्येक version change च्या अगदी आधी dump घ्या. काल रात्रीचा backup आणि तुम्ही आता चालवणार असलेल्या migration च्या आधी घेतलेला backup एकसारखे नसतात.
टॅग निश्चित करा आणि release notes वाचा
त्या फाइलमधील दोन्ही image tags जाणीवपूर्वक निश्चित केले आहेत.
ghcr.io/plankanban/planka:2.2.1 हे October 2026 पर्यंतचे विशिष्ट release आहे. Community 2.3.0 हे November 4, 2026 रोजी security fixes सह release झाले आणि upstream ते update करण्याची शिफारस करतो. Community 2.3.1 हे November 5, 2026 रोजी आले. ज्या board वर username नसलेला member आहे, तिथे card descriptions संपादित करताना होणारा crash त्यात दुरुस्त केला आहे. latest upstream नवीन release प्रकाशित करताच बदलते. त्यामुळे नियमित docker compose pull मुळे तुम्ही निवडलेली नसलेली schema migration अनपेक्षित वेळी लागू होऊ शकते. हा नंबर बदलण्यापूर्वी release notes वाचा. Breaking changes आणि security fixes यांचे वर्णन तिथेच केलेले असते. Version 2.0.3 हे security release म्हणून प्रकाशित झाले होते. त्यामुळे ते नकळत लागू होण्याऐवजी त्याबद्दल आधी वाचणे आवश्यक आहे. August 2026 मध्ये release झालेल्या 2.2.1 बाबतही हेच लागू होते. त्यात path traversal flaw दुरुस्त केला आहे. या त्रुटीमुळे local file storage वापरणाऱ्या instances वरील logged-in user कोणत्याही arbitrary files वाचू शकत होता. या guide मध्ये हाच setup आहे. Advisory मध्ये 2.1.1 आणि त्यापूर्वीच्या आवृत्त्या affected म्हणून नमूद केल्या आहेत. तुम्ही 2.1.x वरून येत असाल, तर आधी 2.2.0 च्या notes वाचा. या release मध्ये फक्त SSO द्वारे sign in केलेल्या users ना deactive केले जाते. Admin त्यांना password देऊन पुन्हा activate करेपर्यंत ते deactive राहतात. येथे pinning सोपे आहे, कारण upstream images प्रकाशित करतो. एखादा project images प्रकाशित करत नसेल, तर अतिरिक्त पायरीसह तुम्ही त्याच शिस्तीचे पालन करणे आवश्यक आहे. checked-out git tag वरून मशीनवर build केलेले openGym हे त्याचे उदाहरण आहे.
postgres:16-alpine अधिक कठोर कारणासाठी major version वर pinned आहे. Postgres आपली data directory major version शी संबंधित format मध्ये लिहितो. वेगळ्या major version ने लिहिलेली directory server उघडण्यास नकार देतो. postgres:latest लिहा, tag 16 च्या पुढे जाऊ द्या, आणि container सुरू होणार नाही. उदाहरणार्थ, 17 image येथे थांबते:
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 रूपांतरित होते, परंतु जुने आणि नवीन server binaries एकाच वेळी उपलब्ध असणे आवश्यक असते. तिसरा पर्याय म्हणजे नवीन version चालवणाऱ्या server कडे logical replication करणे आणि त्यानंतर switchover करणे. प्रत्येक मार्ग ही नियोजित migration आहे; image pull चा अनपेक्षित परिणाम नाही. Logical replication मुळे नवीन server अद्ययावत होईपर्यंत जुना server चालू ठेवता येतो.
तुम्ही fresh setup सुरू करण्याऐवजी विद्यमान Planka 1.x install हलवत असाल, तर त्या upgrade साठी project documentation मध्ये स्वतंत्र documented procedure आहे. आधी घेतलेल्या backup शिवाय version 1 वर परत जाण्याचा कोणताही मार्ग नाही.
अपयशाच्या स्थिती आणि दिसणारे संदेश
Planka वारंवार रीस्टार्ट होते आणि log मध्ये database चा उल्लेख असतो. DATABASE_URL मधील credentials Postgres environment शी जुळत नाहीत. लक्षात ठेवा, POSTGRES_PASSWORD फक्त data directory पहिल्यांदा initialise होताना लागू होते. त्यामुळे पहिल्या boot नंतर variable दुरुस्त केल्याने काहीही बदलत नाही. Configured password शी जुळण्यासाठी ALTER ROLE वापरून database role चा password बदला; db-data volume काढून टाकणे हा फक्त डेटा जतन करण्याची गरज नसलेल्या disposable installation साठीचा पर्याय आहे.
Login यशस्वी होते, पण board कधीही load होत नाही. BASE_URL browser bar मधील address शी जुळत नाही. त्यामुळे server socket चा origin नाकारतो. Browser console मध्ये /socket.io/ कडे केलेल्या अयशस्वी requests दिसतात.
इतर सर्वकाही कार्यरत असताना uploads अयशस्वी होतात. Bind mount चा मालक root आहे. Host directory वर sudo chown -R 1000:1000 चालवा आणि container restart करा.
Upgrade नंतर attachments गायब होतात. /app/data मूळ uploads volume शी जोडलेले नव्हते. ते volume पुन्हा जोडा किंवा backup मधून files restore करा. त्यानंतर image tag मध्ये पुन्हा बदल करण्यापूर्वी named volume वापरा.
Traefik 404 परत करतो. कोणत्याही router ने request शी match केलेली नाही. Host() rule तुमच्या DNS record शी जुळत नाही किंवा labels Traefik पर्यंत पोहोचलेले नाहीत. Substitution नंतरचे labels docker compose config मध्ये दिसतात. येथे typing mistakes स्पष्ट होतात. 502 याचा अर्थ route शी match झाले, पण container पर्यंत पोहोचता आले नाही. त्यामुळे ते proxy network वर आहे का ते तपासा.
Notifications किंवा webhooks कधीही पोहोचत नाहीत. Planka 2 बाहेर जाणाऱ्या HTTP requests अंतर्गत filter मधून पाठवते. Default block list मध्ये localhost आणि postgres समाविष्ट आहेत. localhost कडे निर्देश करणारा webhook रचनेनुसार blocked असतो. तसेच OUTGOING_ALLOWED_HOSTS सेट केल्यानंतर त्या list मध्ये नसलेला प्रत्येक host blocked होतो. Webhook दुसऱ्या container च्या service name कडे निर्देशित करा. Allow list वापरत असल्यास ते नाव OUTGOING_ALLOWED_HOSTS मध्ये जोडा; filter काढून टाकू नका.
एकदा ते चालू झाल्यावर operational load कमी असतो. Release notes तपासा आणि प्रत्येक upgrade पूर्वी database dump घ्या. restart: unless-stopped मुळे reboot नंतर stack आपोआप पुन्हा सुरू होते, मात्र Docker service स्वतः boot वेळी enabled असणे आवश्यक आहे. तसे न झाल्यास कोणती प्रकरणे लागू होतात हे reboot नंतर पुन्हा सुरू होणारे Compose stacks मध्ये दिले आहे.
FAQ
Planka मध्ये लॉग इन केल्यानंतर लोडिंग सतत का सुरू राहते?
क्रेडेन्शियल्स स्वीकारली गेली, परंतु live connection स्वीकारले गेले नाही. ब्राउझर पेजच्या origin शी socket उघडतो, तर Planka त्याला अनुमती असलेले socket origins BASE_URL मधून ठरवतो. त्यामुळे तुम्ही साइटवर https://kanban.example.com द्वारे पोहोचत असताना ते variable http://localhost:3000 वर ठेवले, तर server connection नाकारतो. Developer console मध्ये /socket.io/ कडे केलेल्या अयशस्वी requests दिसतात. BASE_URL मध्ये trailing slash शिवाय अचूक सार्वजनिक address सेट करा. Reverse proxy कडून पाठवला जाणारा X-Forwarded-Proto header app ने स्वीकारावा यासाठी TRUST_PROXY=true जोडा. त्यानंतर docker compose up -d चालवा.
पहिला Planka admin user कसा तयार करायचा?
Version 1.13 पासून administrator आपोआप तयार केला जात नाही. एकतर DEFAULT_ADMIN_EMAIL सेट करून त्याच्याशी संबंधित password, name आणि username variables सेट करा आणि stack सुरू करा, किंवा docker compose run --rm planka npm run db:create-admin-user चालवून prompts ची उत्तरे द्या. Shared server वर interactive command अधिक सुरक्षित आहे, कारण password container च्या configured environment मध्ये जात नाही आणि docker inspect ते वाचू शकत नाही. नंतर DEFAULT_ADMIN_EMAIL सेट ठेवल्यास त्या account चे name, role आणि email address बदलता येत नाहीत आणि interface मधून ते delete करता येत नाही. Setup झाल्यानंतर DEFAULT_ADMIN_PASSWORD काढा, कारण ते सेट ठेवले तर startup वेळी संबंधित account चा password reset होतो.
Planka attachments आणि avatars कुठे साठवते?
Planka 2 मध्ये attachments, user avatars आणि board backgrounds यांसह सर्व uploaded files container मधील /app/data अंतर्गत साठवल्या जातात. तो path named volume वर mount करा. Explicit mount नसल्यास Docker image anonymous volume वापरते. त्यानंतरचा docker compose up, docker compose down नंतर तो volume आपोआप पुन्हा जोडत नाही. Bind mount देखील वापरता येतो. मात्र Node process UID 1000 म्हणून चालतो. त्यामुळे host directory वर sudo chown -R 1000:1000 चालवा; अन्यथा uploads permission error मुळे अपयशी ठरतात.
Self-hosted Planka ला किती RAM आवश्यक आहे?
या प्रकल्पाच्या technical FAQ मध्ये छोट्या teams साठी किमान 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 चालवा आणि तुमच्या स्वतःच्या आकडेवारीनुसार आकार ठरवा. Memory पेक्षा disk वर अधिक बारकाईने लक्ष ठेवा, कारण attachments मुळे वापर वाढतो.
Data गमावल्याशिवाय Planka upgrade कसे करायचे?
Upgrade च्या अगदी आधी database dump घ्या आणि uploads volume चे archive तयार करा; मागील रात्रीच्या schedule वर अवलंबून राहू नका. docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql वापरा आणि redirected output साठी pseudo-terminal allocation बंद ठेवण्यासाठी -T ठेवा. तुम्ही वगळत असलेल्या प्रत्येक version साठी release notes वाचा. Image tag latest ऐवजी विशिष्ट release वर बदला. त्यानंतर docker compose pull आणि docker compose up -d चालवा आणि migration साठी log monitor करा. Postgres tag त्याच्या major version वर pinned ठेवा, कारण वेगळ्या major version ने लिहिलेली data directory server उघडण्यास नकार देतो.