Docker Compose ఉపయోగించి Planka ను self-host చేయడం ఎలా?
Docker Compose ద్వారా Planka ను VPS లో డిప్లాయ్ చేయండి. Postgres, Traefik సెటప్ మరియు లాగిన్ సమస్యలను నివారించడానికి BASE_URL వేరియబుల్ ను ఎలా కాన్ఫిగర్ చేయాలో ఈ గైడ్ వివరిస్తుంది.
Planka ను self-host చేయడం వల్ల మీకు లభించేవి
Planka ను self-host చేయడం ద్వారా మీ టీమ్కు Trello లో ఉండే కార్డ్, లిస్ట్ మరియు లేబుల్ మోడల్తో కూడిన Kanban బోర్డు లభిస్తుంది, ఇది మీరు నియంత్రించే VPS పై నడుస్తుంది. ఇందులో సీట్ల పరిమితి లేదా ప్రతి వినియోగదారునికి బిల్లింగ్ ఉండదు, ఎందుకంటే సర్వర్ ఖర్చు మాత్రమే ఉంటుంది. ఈ గైడ్ దీనిని Docker Compose ఉపయోగించి Traefik వెనుక డిప్లాయ్ చేస్తుంది, డేటా కోసం Postgres ను మరియు వినియోగదారులు అప్లోడ్ చేసే ప్రతి ఫైల్ కోసం ఒక named volume ను ఉపయోగిస్తుంది.
Planka 2 ప్రాజెక్ట్ యొక్క స్వంత Fair Use License కింద విడుదల చేయబడింది, దీనిని ప్రాజెక్ట్ ఓపెన్ సోర్స్ అని కాకుండా source-available అని పేర్కొంటుంది. మీ సంస్థ యొక్క అంతర్గత ప్రాజెక్ట్ల కోసం దీనిని రన్ చేయడానికి అనుమతి ఉంది. దీనిని మూడవ పక్షాలకు వాణిజ్యపరమైన హోస్టెడ్ సర్వీస్గా అందించడానికి Pro లేదా Enterprise లైసెన్స్ అవసరం.
Trello యొక్క ఉచిత ప్లాన్ నుంచి బయటకు వస్తున్న ఇద్దరు నుండి ఐదుగురు సభ్యులున్న టీమ్ కోసం ఈ గైడ్ రూపొందించబడింది. మీరు ఏ బోర్డును ఎంచుకోవాలో ఇంకా నిర్ణయించుకోకపోతే, ముందుగా self-hosted Trello ప్రత్యామ్నాయాల పోలికను చదవండి. ఈ గైడ్ మీరు ఇప్పటికే నిర్ణయం తీసుకున్నారని భావించి, కేవలం డిప్లాయ్మెంట్ గురించి మాత్రమే వివరిస్తుంది.
మీకు Docker Engine మరియు Compose plugin రన్ అవుతున్న VPS, మరియు దానిని సూచించే DNS A record అవసరం. అలాగే, ఆ బాక్స్పై ఇప్పటికే TLS (transport layer security) ను terminate చేస్తున్న Traefik ఇన్స్టాన్స్ ఉండాలి. Traefik ఇంకా లేకపోతే, ముందుగా అనేక Compose అప్లికేషన్ల ముందు Traefik reverse proxy ని సెటప్ చేయండి, మరియు కింద ఉన్న ఫైల్ మీకు కొత్తగా అనిపిస్తే Docker Compose ప్రాథమిక అంశాలను చదవండి.
Planka కు ఎంత VPS అవసరం?
ప్రాజెక్ట్కు సంబంధించిన సాంకేతిక FAQ చిన్న బృందాల కోసం కనీసం 2 GB RAM మరియు 10 GB storage సిఫార్సు చేస్తుంది. కాబట్టి ఆ సంఖ్యలను ఖచ్చితమైన కొలతగా కాకుండా ప్రారంభ అంచనాగా పరిగణించండి.
వాస్తవంగా నడిచేది తక్కువ పరిమాణంలో ఉంటుంది: API మరియు build చేసిన frontend ను అందించే ఒక Node.js process, అలాగే data ను నిల్వ చేసే Postgres server. Postgres ఒక supervising process తో పాటు ప్రతి open connection కు ఒక backend process ను నడుపుతుంది. Planka container లో ఒక చిన్న proxy process కూడా నడుస్తుంది. ఇది బయటికి పంపే requests ను filter చేస్తుంది. 2 GB plan చిన్న బృందాల కోసం ప్రాజెక్ట్ RAM సిఫార్సుకు సరిపోతుంది. ఒక board కు తక్కువ వనరులే అవసరం. అదే VPS లో మీ బృందం documents కూడా ఉండాల్సి ఉంటే, ముందుగా ఆ అప్లికేషన్కు సరిపోయే పరిమాణాన్ని నిర్ణయించండి: Notion-style workspace గా AFFiNE ను నడపడానికి Planka అవసరాలు ప్రారంభమయ్యేలోపే స్వంతంగా రెండు గిగాబైట్ల పరిధిలో memory అవసరం కావచ్చు.
Memory పరిమాణాన్ని నిర్ణయించే ముందు disk పరిమాణాన్ని నిర్ణయించండి, ఎందుకంటే attachments పెరుగుతూనే ఉంటాయి. ఈ పేరాను నమ్మకుండా మీ స్వంత instance ను కొలవండి:
docker stats --no-stream
docker system df -vమొదటి command ప్రతి container కు ప్రస్తుత memory మరియు CPU వినియోగాన్ని చూపుతుంది. రెండవది ప్రతి volume లో ఎంత స్థలం ఉందో చూపుతుంది. ఈ రెండు readings ను సాధారణ పని వారం తర్వాత తీసుకోండి. Installation రోజున తీసుకోకండి, ఎందుకంటే idle board మీ బృందం వినియోగం గురించి ఏమీ చెప్పదు.
Compose ఫైల్ను రాయడం
డైరెక్టరీని సృష్టించి, దాని ownership ను మీకు ఇవ్వండి. అప్పుడు ఈ ఫైళ్లను sudo ద్వారా ఎప్పుడూ edit చేయాల్సిన అవసరం ఉండదు.
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 పాడవదు. 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 లేదు. Traefikproxynetwork ద్వారా container ను చేరుతుంది. అందువల్ల port 1337 host పై ఎప్పుడూ publish కాదు. దాన్ని publish చేస్తే మీ proxy మరియు certificate ను దాటుకుని ఎవరైనా సేవను చేరగలరు. loadbalancer.server.port=1337container లోని port పేరును సూచిస్తుంది. Planka 1337 పై listen చేస్తుంది. Upstream example దాన్ని 3000 పై మాత్రమే చేరుతుంది, ఎందుకంటే అది port ను host కు map చేస్తుంది. ఇక్కడ host mapping లేదు. అందువల్ల container port 1337 అని Traefik కు తెలియజేయాలి.condition: service_healthyPostgres healthcheck తో కలిసి పనిచేస్తుంది. ఇది లేకపోతే database connections అంగీకరించే ముందు Planka ప్రారంభమవుతుంది. దాని మొదటి query విఫలమై, process exit అవుతుంది. అప్పుడు అది crash loop లాగా కనిపిస్తుంది. ఈ విధానం Compose healthchecks మరియు startup orderingలో వివరించబడింది.- Database service కు ఉద్దేశపూర్వకంగా
postgresఅని పేరు పెట్టారు. Planka 2 తన outgoing requests ను internal filter ద్వారా పంపుతుంది. ఆ filter యొక్క default block list లోlocalhost,postgresఉంటుంది. Service పేరు మార్చితే database ఆ జాబితా నుంచి నిశ్శబ్దంగా తొలగిపోతుంది.
ఏదైనా ప్రారంభించే ముందు Compose మీ secrets ను చూడగలదో లేదో తనిఖీ చేయండి:
docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'ఇది .env విలువలు ఇప్పటికే substitute చేసిన file ను చూపిస్తుంది. Empty value కనిపిస్తే Compose .env file ను చదవడం లేదు. సాధారణంగా మీరు command ను వేరే directory నుంచి run చేయడం వల్ల ఇది జరుగుతుంది.
అడ్మిన్ bootstrap variables వాస్తవంగా ఏం చేస్తాయి
Planka 1.13 నుంచి administrator మీ కోసం సృష్టించబడదు. అందువల్ల కొత్త databaseలో login చేయగల user ఎవరూ ఉండరు. దీన్ని పరిష్కరించడానికి DEFAULT_ADMIN_* group రెండు మార్గాల్లో ఒకటి.
ప్రారంభ సమయంలో Planka DEFAULT_ADMIN_EMAIL కు సరిపోలే user కోసం చూస్తుంది. అలాంటి user లేకపోతే, దానికి సంబంధించిన password, display name, username విలువలతో ఒక userను సృష్టిస్తుంది. తరువాతి ప్రారంభాల్లో కూడా ఈ variablesతో సరిపోలే accountను update చేస్తుంది. DEFAULT_ADMIN_PASSWORD విలువ అలాగే ఉంటే, ఆ account passwordను కూడా reset చేస్తుంది.
DEFAULT_ADMIN_EMAIL మరో పని కూడా చేస్తుంది. ఈ variable సెట్గా ఉన్నంతకాలం, అది సూచించే account పేరు, role లేదా email addressను interface ద్వారా మార్చలేరు. ఆ accountను delete చేయడం కూడా సాధ్యం కాదు. ఇది lock-out guardగా పనిచేస్తుంది. అందుకే UIలో ఆ account పేరు లేదా email addressను మార్చలేరు. Variableను తొలగించి restart చేస్తే, ఆ accountను ఇతర adminల మాదిరిగా edit చేయగల సాధారణ adminగా మార్చవచ్చు.
Password line విషయంలో జాగ్రత్త అవసరం. environment: లోని ఏదైనా విలువను containerపై docker inspect అమలు చేయగల ఎవరైనా చదవగలరు. అందువల్ల DEFAULT_ADMIN_PASSWORD అక్కడ శాశ్వతంగా ఉండకూడదు. Login చేసి, ఆ lineను తొలగించండి. తరువాత docker compose up -d ను మళ్లీ అమలు చేసి, interfaceలో మీ passwordను మార్చండి.
మరింత సురక్షితమైన మార్గంలో variablesను పూర్తిగా ఉపయోగించరు. మొత్తం DEFAULT_ADMIN_* groupను comment out చేసి, accountను interactiveగా సృష్టించండి:
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లో విడుదలైన version 2.2.0లో OIDC, SSOలను PLANKA Proలోకి మార్చారు. అదే విడుదలలో Community editionకు local accounts కోసం two-factor authentication (TOTP) అందించారు. కాబట్టి కనీసం admin account కోసం దీన్ని enable చేయండి.
hostname సరిపోలకపోతే BASE_URL loginలను ఎందుకు విఫలపరుస్తుంది
BASE_URL అనేది schemeతో, చివరలో slash లేకుండా, వ్యక్తులు browserలో టైప్ చేసే ఖచ్చితమైన address. ఈ stack కోసం అది https://kanban.example.com. Planka తన linksను, అనుమతించబడిన WebSocket origins జాబితాను ఈ విలువ ఆధారంగా రూపొందిస్తుంది. అందువల్ల తప్పు BASE_URL ఉంటే స్పష్టమైన error కనిపించదు. Page load అవుతుంది, కానీ loading ఎప్పటికీ పూర్తికాదు.
సాధారణంగా ఇలా జరుగుతుంది: మీరు upstream exampleను copy చేసి, BASE_URL=http://localhost:3000 ను అలాగే ఉంచుతారు. తరువాత మీ అసలు domainపై HTTPS ద్వారా siteను తెరుస్తారు. 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 లేకపోతే, Traefik సెట్ చేసే X-Forwarded-Proto మరియు X-Forwarded-For headersను app పరిగణించదు. దాంతో connection సురక్షితం కాదని app భావిస్తుంది. ప్రతి clientను ఒకే shared IP addressగా కూడా పరిగణిస్తుంది. TRUST_PROXY సెట్ చేసినప్పుడు, app ఆ headersను చదివి browserతో scheme విషయంలో సరిపోతుంది.
Traefik WebSocketsను అదనపు configuration లేకుండానే proxy చేస్తుంది. అందుకే ఈ సందర్భంలో Traefikను ఎంచుకోవడం సముచితం. nginxలో proxy upgrade headers, proxy_set_header Upgrade $http_upgrade మరియు proxy_set_header Connection "upgrade" ను forward చేయాలి. లేకపోతే వేరే కారణంతో అదే stuck spinner కనిపిస్తుంది. వీటిని సాధారణ location / blockలో ఉంచవచ్చు. /socket.io కోసం ప్రత్యేక block కూడా పనిచేస్తుంది, కానీ అది అవసరం లేదు.
తరువాత boardను కొత్త hostnameకు మార్చాలంటే రెండు విషయాలను కలిపి మార్చాలి: BASE_URL విలువ మరియు Traefik Host() rule. ఒకదాన్ని మార్చి మరొకదాన్ని మర్చిపోతే, మళ్లీ spinner సమస్య వస్తుంది. https://example.com/planka వంటి subpath నుంచి Plankaను అందించడం version 2.1.0 నుంచి, March 2026లో విడుదలైన versionతో, పనిచేస్తుంది. పాత tagsలో Plankaకు ప్రత్యేక subdomain ఇవ్వండి.
Planka attachments మరియు avatars ను ఎక్కడ నిల్వ చేస్తుంది
Planka 2లో user upload చేసే ప్రతిదీ container లోని ఒకే path కింద నిల్వ అవుతుంది: /app/data. Attachments, user avatars, board background images అన్నీ దీని కింద ఉంటాయి. Version 1లో మూడు వేర్వేరు directories ఉండేవి. అందువల్ల పాత write-up నుంచి copy చేసిన Compose file ఇప్పుడు లేని paths ను mount చేస్తుంది. అవసరమైన data mount అందులో ఉండదు.
ఈ ఒకే mount వల్ల upgrade తర్వాత board సురక్షితంగా నిలిచే పరిస్థితి, డేటా కోల్పోయే పరిస్థితి మధ్య తేడా ఏర్పడుతుంది. Docker image /app/data ను volume గా ప్రకటిస్తుంది. అందువల్ల Compose నుంచి ఈ mount ను తొలగిస్తే uploads anonymous volume లో నిల్వ అవుతాయి. సాధారణ up recreation సమయంలో Compose దాన్ని ఉంచుతుంది. కానీ తరువాత down చేసి, ఆపై up అమలు చేస్తే దాన్ని స్వయంచాలకంగా మళ్లీ అనుసంధానించదు. Board సరిగ్గా కనిపిస్తుంది, cards అన్నీ ఉంటాయి. కానీ ప్రతి attachment link పనిచేయదు. కారణం database rows ఇప్పటికీ పాత volume లోని files ను సూచిస్తుండటమే.
పై Compose file లోని named volume ఈ సమస్యను నివారిస్తుంది. Bind mount కూడా పనిచేస్తుంది. సాధారణ tools తో files ను backup చేయడం అది సులభం చేస్తుంది. అయితే దీనికి ఒక అదనపు దశ అవసరం. Container లోని Node process UID 1000తో నడుస్తుంది. అందువల్ల host directory root యాజమాన్యంలో ఉంటే మొదటి upload సమయంలో permission error వస్తుంది:
sudo chown -R 1000:1000 /opt/planka/dataఈ రెండు ఎంపికల మధ్య తేడాలను named volumes కు వ్యతిరేకంగా bind mounts లో వివరించాం.
మీ plan లోని disk కంటే attachments పరిమాణం పెరిగితే, Planka వాటిని S3-compatible storage కు రాయగలదు. ఇందుకోసం S3_ENDPOINT, S3_BUCKET మరియు వాటికి సరిపడే key variables ఉపయోగించాలి. ఇది hosted bucket కు లేదా మరో machine లోని self-hosted MinIO object store కు సూచించవచ్చు. Team board ను నింపే ముందు ఈ నిర్ణయం తీసుకోండి. S3ను enable చేసిన తర్వాత file reads, writes ఆ backend కు మారతాయి. ఇప్పటికే ఉన్న uploads మాత్రం migrate కావు.
స్టాక్ను ప్రారంభించి, అది పనిచేసిందో తనిఖీ చేయండి
docker compose pull
docker compose up -d
docker compose psdocker compose ps లో postgres విలువ healthy గా, planka విలువ running గా కనిపించాలి. Planka పునఃప్రారంభ చక్రంలో ఉంటే, ముందుగా తనిఖీ చేయాల్సింది అప్లికేషన్ కాదు, 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 లోని POSTGRES_USER మరియు POSTGRES_PASSWORD విలువలతో DATABASE_URL ను పోల్చండి.
తర్వాత VPS నుంచి కాకుండా, మీ స్వంత machine నుంచి route ను తనిఖీ చేయండి:
curl -I https://kanban.example.comHTTP/2 200 అంటే Traefik certificate ను కలిగి ఉండి, container ను చేరుకుంటోందని అర్థం. Traefik అందించిన 404 అంటే ఏ router కూడా request కు సరిపోలలేదని అర్థం. మీరు పంపిన hostname కు Host() rule సరిపోలకపోవచ్చు, లేదా Traefik labels ను ఎప్పుడూ గుర్తించకపోయి ఉండవచ్చు. 502 అంటే router సరిపోలింది, కానీ Traefik container ను చేరుకోలేకపోయిందని అర్థం. ఉదాహరణకు, container proxy network కు అనుసంధానించబడకపోవచ్చు. ఇప్పుడు site ను తెరిచి, admin account తో log in చేయండి.
ప్రతి version bump కు ముందు pg_dump తీసుకోండి
మీ board ను రెండు వేర్వేరు storesలో ఉంచుతారు. అందువల్ల 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 plain output stream లోనే ఉంటుంది.
తర్వాత uploads కోసం backup తీసుకోండి. ముందుగా నిజమైన volume పేరు కనుగొనండి. ఎందుకంటే Compose దానికి project directory పేరును prefix గా జతచేస్తుంది.
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లో ఉంచుతుంది. రెండు విధానాల్లో ఏదైనా సరే. మీరు ఎప్పుడూ restore చేయని backup ఉపయోగకరం కాదు. అందువల్ల ఒకసారి దాన్ని scratch VPSపై restore చేసి, login చేయగలరని మరియు attachment తెరవగలరని నిర్ధారించండి. Uploadsను స్వీకరించే ప్రతి Compose appలో ఇదే రెండు stores కనిపిస్తాయి. కాబట్టి తరువాత మీ support desk ఉన్న అదే boxపై Chatwootను ఉంచినా, volume పేర్లు మారడం మినహా మీరు ఇక్కడ రూపొందించిన routine దాదాపు అలాగే వర్తిస్తుంది.
ప్రతి version changeకు కచ్చితంగా ముందు dump తీసుకోండి. గత రాత్రి తీసుకున్న backup, మీరు అమలు చేయబోయే migrationకు ముందు తీసుకున్న backupతో సమానం కాదు.
Tags ను pin చేసి, release notes చదవండి
ఆ file లోని రెండు image tags ను ఉద్దేశపూర్వకంగా pin చేశారు.
ghcr.io/plankanban/planka:2.2.1 ఒక నిర్దిష్ట release. ఇది October 2026 నాటికి ప్రస్తుత release. Community 2.3.0 November 4, 2026 న security fixes తో విడుదలైంది. Upstream దానికి update చేయాలని సిఫారసు చేస్తోంది. Community 2.3.1 November 5, 2026 న విడుదలైంది. Username లేని member ఉన్న boards లో card descriptions ను edit చేసినప్పుడు ఏర్పడే crash ను అది పరిష్కరిస్తుంది. Upstream కొత్త release ప్రచురించిన ప్రతిసారి latest మారుతుంది. అందువల్ల సాధారణ docker compose pull మీరు ఎంచుకోని సమయంలో schema migration ను తీసుకురావచ్చు. ఆ సంఖ్యను మార్చే ముందు release notes చదవండి. Breaking changes మరియు security fixes అక్కడే వివరించబడతాయి. Version 2.0.3 ను security release గా ప్రచురించారు. అనుకోకుండా ఎదుర్కొనడం కంటే ముందుగానే చదవాల్సిన మార్పు ఇదే. August 2026 లో విడుదలైన 2.2.1 కూడా ఇదే విధమైన security release. Local file storage ను ఉపయోగించే instances లో logged-in user arbitrary files ను చదవగలిగే path traversal లోపాన్ని అది పరిష్కరిస్తుంది. ఈ guide లో అదే setup ఉపయోగించబడుతుంది. ఈ లోపం వల్ల ప్రభావితమైన versions గా advisory 2.1.1 మరియు అంతకుముందు versions ను పేర్కొంటుంది. మీరు 2.1.x నుంచి వస్తే, ముందుగా 2.2.0 notes చదవండి. ఎందుకంటే admin వారికి password ఇచ్చి మళ్లీ activate చేసే వరకు, SSO ద్వారా మాత్రమే ఎప్పుడైనా sign in చేసిన users ను ఆ release deactivate చేస్తుంది. Upstream images ను ప్రచురిస్తున్నందున ఇక్కడ pin చేయడం సులభం. ఏ project images ను విడుదల చేయకపోతే, అదనపు దశతో ఇదే క్రమశిక్షణ పాటించాలి. చెక్అవుట్ చేసిన git tag నుంచి machine పై నిర్మించిన openGym విషయంలో కూడా అదే విధానం.
postgres:16-alpine ను major version కు pin చేయడానికి మరింత ముఖ్యమైన కారణం ఉంది. Postgres తన data directory ను major version కు అనుసంధానమైన format లో రాస్తుంది. వేరే major version రాసిన directory ను server open చేయడానికి నిరాకరిస్తుంది. postgres:latest ను రాసి, tag 16 దాటి ముందుకు వెళ్లేలా చేస్తే container ప్రారంభం కాదు. ఉదాహరణకు, 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.ఏ data కోల్పోదు. Restart చేయడం వల్ల సమస్య పరిష్కారం కాదు. కొత్త Postgres major కు మారడానికి పాత version నుంచి dump తీసుకుని, కొత్త version లోని fresh data directory కి restore చేయాలి. లేదా dump లేకుండా data ను మార్చే pg_upgrade run ను ఉపయోగించాలి; దీనికి పాత మరియు కొత్త server binaries రెండూ ఒకేసారి అందుబాటులో ఉండాలి. మరో మార్గం ఏమిటంటే, కొత్త version నడుస్తున్న server కు logical replication ఏర్పాటు చేసి, ఆ తర్వాత switchover చేయడం. ప్రతి మార్గం ఒక ప్రణాళికాబద్ధమైన migration. Image pull వల్ల ఇది అనుకోకుండా జరగకూడదు. Logical replication ఉపయోగిస్తే, కొత్త server పూర్తిగా సమకాలీకరించే వరకు పాత server నడుస్తూనే ఉంటుంది.
మీరు కొత్తగా ప్రారంభించకుండా ఇప్పటికే ఉన్న Planka 1.x install ను మార్చుతున్నట్లయితే, ఆ upgrade కు project documentation లో ప్రత్యేకంగా వివరించిన procedure ఉంది. ముందుగా backup తీసుకోకపోతే version 1 కు తిరిగి వెళ్లే మార్గం లేదు.
వైఫల్య పరిస్థితులు మరియు మీరు చూసే సందేశాలు
Planka నిరంతరం restart అవుతూ, logలో database పేరు కనిపిస్తోంది. DATABASE_URL లోని credentials Postgres environmentతో సరిపోలడం లేదు. POSTGRES_PASSWORD data directoryను మొదట initialise చేసినప్పుడు మాత్రమే వర్తిస్తుందని గుర్తుంచుకోండి. అందువల్ల మొదటి boot విఫలమైన తర్వాత variableను సరిచేసినా ఎలాంటి మార్పు ఉండదు. Configured passwordకు సరిపడేలా database role passwordను ALTER ROLE తో మార్చండి. Data ఉంచాల్సిన అవసరం లేని disposable installationలో మాత్రమే db-data volumeను తొలగించడం ఒక ఎంపిక.
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కు attach కాలేదు. ఆ volumeను మళ్లీ attach చేయండి లేదా backup నుంచి filesను restore చేయండి. తరువాత image tagను మళ్లీ మార్చే ముందు named volumeను ఉపయోగించండి.
Traefik 404ను return చేస్తోంది. Requestకు ఏ router కూడా match కాలేదు. Host() rule మీ DNS recordతో సరిపోలకపోవచ్చు లేదా labels Traefikకు చేరకపోయి ఉండవచ్చు. Substitution తర్వాత labelsను docker compose config చూపిస్తుంది. Typoలు ఎక్కడున్నాయో అక్కడే స్పష్టంగా కనిపిస్తాయి. 502 వస్తే route match అయింది, కానీ containerను చేరుకోలేకపోయిందని అర్థం. కాబట్టి అది proxy networkలో ఉందో పరిశీలించండి.
Notifications లేదా webhooks ఎప్పటికీ చేరడం లేదు. Planka 2 తన outgoing HTTP requestsను internal filter ద్వారా పంపుతుంది. Default block listలో localhost మరియు postgres ఉంటాయి. localhost వైపు పంపే webhook design ప్రకారమే block అవుతుంది. OUTGOING_ALLOWED_HOSTS సెట్ చేసిన తర్వాత ఆ listలో లేని ప్రతి host కూడా block అవుతుంది. Filterను తొలగించకుండా webhookను ఇతర container service nameకు point చేయండి. Allow listను ఉపయోగిస్తే ఆ nameను OUTGOING_ALLOWED_HOSTS కు జోడించండి.
ఇది runningలోకి వచ్చిన తర్వాత operational load తక్కువగా ఉంటుంది. Release notesను monitor చేయండి. ప్రతి upgradeకు ముందు databaseను dump చేయండి. restart: unless-stopped కారణంగా reboot చేసినప్పుడు stack స్వయంగా తిరిగి వస్తుంది. అయితే Docker service boot సమయంలో enabledగా ఉండాలి. అది జరగని సందర్భాలను reboot తర్వాత తిరిగి ప్రారంభమయ్యే Compose stacks వివరిస్తుంది.
FAQ
నేను login చేసిన తర్వాత Planka ఎందుకు నిరంతరం load అవుతుంది?
Credentials ఆమోదించబడ్డాయి, కానీ live connection ఆమోదించబడలేదు. Browser page origin కు తన socket ను తెరుస్తుంది. Planka అనుమతించబడిన socket origins ను BASE_URL నుంచి రూపొందిస్తుంది. కాబట్టి మీరు సైట్ను https://kanban.example.com వద్ద access చేస్తున్నప్పుడు ఆ variable ను http://localhost:3000 వద్దే ఉంచితే server connection ను reject చేస్తుంది. Developer console లో /socket.io/ కు విఫలమైన requests కనిపిస్తాయి. BASE_URL ను trailing slash లేకుండా ఖచ్చితమైన public address కు set చేయండి. మీ 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 variables తో DEFAULT_ADMIN_EMAIL ను set చేసి stack ను start చేయండి. లేదా docker compose run --rm planka npm run db:create-admin-user ను run చేసి prompts కు సమాధానం ఇవ్వండి. Shared server పై interactive command సురక్షితమైనది. ఎందుకంటే password container యొక్క configured environment లోకి వెళ్లదు. అక్కడ docker inspect దాన్ని చదవగలదు. తరువాత కూడా DEFAULT_ADMIN_EMAIL ను set గా ఉంచితే ఆ account యొక్క name, role మరియు email address మార్పులను నిరోధిస్తుంది. Interface నుంచి ఆ account deletion ను కూడా నిరోధిస్తుంది. Setup పూర్తయిన తర్వాత DEFAULT_ADMIN_PASSWORD ను remove చేయండి. దాన్ని అలాగే ఉంచితే startup సమయంలో matching account password reset అవుతుంది.
Planka attachments మరియు avatars ను ఎక్కడ నిల్వ చేస్తుంది?
Planka 2 లో upload చేసిన అన్ని files container లోని /app/data కింద ఉంటాయి. ఇందులో attachments, user avatars మరియు board backgrounds కూడా ఉన్నాయి. ఆ path ను named volume పై mount చేయండి. స్పష్టమైన mount లేకపోతే Docker image anonymous volume ను ఉపయోగిస్తుంది. తరువాత జరిగే docker compose up సమయంలో ఆ volume ను docker compose down తర్వాత స్వయంచాలకంగా మళ్లీ connect చేయదు. Bind mount కూడా పనిచేస్తుంది. అయితే Node process UID 1000 గా నడుస్తుంది. అందువల్ల host directory పై sudo chown -R 1000:1000 ను run చేయండి. లేకపోతే uploads permission error తో విఫలమవుతాయి.
Self-hosted Planka కు ఎంత RAM అవసరం?
చిన్న teams కోసం project యొక్క technical FAQ కనీసం 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 చేయండి. మీ స్వంత usage numbers ఆధారంగా పరిమాణాన్ని నిర్ణయించండి. Memory కంటే disk ను మరింత జాగ్రత్తగా monitor చేయండి. పెరిగేది 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 ను ఉపయోగించండి. Redirect చేసిన output కోసం pseudo-terminal allocation ను disable చేయడానికి -T ను ఉంచండి. మీరు skip చేసే ప్రతి version కు release notes చదవండి. Image tag ను latest బదులుగా నిర్దిష్ట release కు మార్చండి. తరువాత docker compose pull మరియు docker compose up -d ను run చేయండి. Migration కోసం log ను monitor చేయండి. Postgres tag ను దాని major version కు pin చేసి ఉంచండి. వేరే major version రాసిన data directory ను server open చేయదు.