Paano i-self-host ang Planka gamit ang Docker Compose
I-deploy ang Planka sa VPS gamit ang Docker Compose, Postgres, at Traefik. Makikita rin ang admin bootstrap variables at ang BASE_URL na sumisira sa login.
Mga makukuha mo sa self-hosting ng Planka
Ang self-hosting ng Planka ay nagbibigay sa team mo ng Kanban board na may modelo ng card, list, at label na pamilyar na sa mga gumagamit ng Trello. Tumatakbo ito sa isang VPS na kontrolado mo. Walang limitasyon sa bilang ng seat at walang singil kada user, dahil server lamang ang tanging gastos. Ide-deploy ng guide na ito ang Planka gamit ang Docker Compose sa likod ng Traefik, Postgres para sa data, at named volume para sa bawat file na ina-upload ng mga user.
Ang Planka 2 ay inilalabas sa ilalim ng sariling Fair Use License ng proyekto. Inilalarawan ito ng proyekto bilang source-available at hindi open source. Pinapayagan ang paggamit nito para sa mga internal project ng sarili mong organisasyon. Para ialok ito sa third party bilang commercial hosted service, kailangan ng Pro o Enterprise license.
Ang target na reader ko ay team na binubuo ng dalawa hanggang lima na umaalis sa free tier ng Trello. Kung nagpapasya ka pa lamang kung aling board ang gagamitin, basahin muna ang paghahambing ng mga self-hosted na alternatibo sa Trello. Ipinapalagay ng guide na ito na napili na ang board at ang deploy lamang ang saklaw nito.
Kailangan mo ng VPS na nagpapatakbo ng Docker Engine na may Compose plugin, at DNS A record na nakaturo rito. Kailangan mo rin ng Traefik instance na naka-configure na para mag-terminate ng TLS (transport layer security) sa server na iyon. Kung wala pa ang Traefik, i-set up muna ang Traefik reverse proxy sa harap ng ilang Compose app, at basahin ang mga pangunahing kaalaman sa Docker Compose para sa VPS kung hindi pamilyar sa iyo ang file sa ibaba.
Gaano karaming VPS resources ang kailangan ng Planka?
Inirerekomenda ng technical FAQ ng proyekto ang hindi bababa sa 2 GB RAM at 10 GB storage para sa maliliit na team. Ituring ang mga numerong ito bilang panimulang punto, hindi bilang eksaktong sukat.
Maliit lamang ang aktuwal na tumatakbo: isang Node.js process para maghatid ng API at built frontend, at isang Postgres server na naglalaman ng data. Tumatakbo rito ang isang supervising process at tig-isang backend process para sa bawat bukas na connection. May maliit ding proxy process sa loob ng Planka container para salain ang mga outgoing request nito. Ang 2 GB plan ay tumutugma sa RAM recommendation ng proyekto para sa maliliit na team. Magaan lang ang isang board, kaya kung ang parehong VPS ay maglalaman din ng mga dokumento ng team ninyo, unahin ang sizing ng app na iyon: pagpapatakbo ng AFFiNE bilang workspace na gaya ng Notion ay nangangailangan na ng ilang gigabytes para sa sarili nito bago pa humingi ng resources ang Planka.
Unahin ang pag-size ng disk bago ang memory, dahil ang mga attachment ang bahagi na lumalaki. Sukatin ang sarili mong instance sa halip na umasa sa talatang ito:
docker stats --no-stream
docker system df -vIpinapakita ng una ang aktuwal na memory at CPU usage ng bawat container. Ipinapakita naman ng pangalawa kung gaano kalaking espasyo ang ginagamit ng bawat volume. Kunin ang dalawang reading pagkatapos ng isang karaniwang linggo ng trabaho, hindi sa araw ng installation, dahil walang ipinapakita tungkol sa team ninyo ang isang idle na board.
Isulat ang Compose file
Gawin ang directory at kunin ang ownership nito, para hindi mo na kailangang i-edit ang mga file na ito sa pamamagitan ng sudo.
sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/plankaI-generate ang secrets sa isang .env file sa tabi ng Compose file. Awtomatikong binabasa ng Compose ang file na iyon at pinapalitan nito ang mga value.
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 .envSinasadya ang openssl rand -hex. Mga digit at letrang a hanggang f lamang ang laman ng hex string, kaya hindi nito masisira ang DATABASE_URL connection string kung saan ito inilalagay. Maaaring maglaman ang standard Base64 ng slash, plus sign, at padding equals sign, ngunit hindi kailanman ng at sign; kailangang i-percent-encode ang mga character na may espesyal na kahulugan sa connection URL. Saklaw ang mas malawak na pattern sa pag-iwas na mailagay ang secrets sa Compose file.
Ngayon, docker-compose.yml. Palitan ang kanban.example.com ng sarili mong hostname sa dalawang lugar kung saan ito lumilitaw.
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:Mahalagang ipaliwanag ang apat na desisyon sa file na iyon, dahil iyon ang mga karaniwang binabago at pinagsisisihan pagkatapos.
- Walang
ports:block sa Planka service. Inaabot ng Traefik ang container sa pamamagitan ngproxynetwork, kaya hindi kailanman inilalathala sa host ang port 1337. Kung ilalathala ito, magkakaroon ang sinuman ng paraan upang lampasan ang proxy at ang certificate mo. - Tinutukoy ng
loadbalancer.server.port=1337ang port sa loob ng container. Nakikinig ang Planka sa 1337, at naaabot lamang ito ng upstream example sa 3000 dahil mina-map nito ang port sa host. Walang host mapping dito, kaya kailangang sabihin sa Traefik ang container port. - Katuwang ng Postgres healthcheck ang
condition: service_healthy. Kung wala ito, magsisimula ang Planka bago tumanggap ng mga connection ang database, mabibigo ang unang query nito, at lalabas ito. Magmumukha itong crash loop. Nasa Compose healthchecks at startup ordering ang mga detalye ng mekanismo. - Sinasadyang
postgresang pangalan ng database service. Sa Planka 2, ipinapadaan ang sarili nitong outgoing requests sa internal filter na ang default block list aylocalhost,postgres. Kapag pinalitan mo ang pangalan ng service, tahimik mong maaalis ang database sa listahang iyon.
Tingnan muna kung nakikita ng Compose ang secrets bago ka magsimula:
docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'Ipi-print nito ang file na napalitan na ang mga value ng .env. Kapag walang value, hindi binabasa ng Compose ang .env file, karaniwan dahil tumatakbo ang command mula sa ibang directory.
Ano talaga ang ginagawa ng admin bootstrap variables
Mula sa Planka 1.13, walang administrator na awtomatikong ginagawa para sa iyo. Kaya walang makakapag-log in sa bagong database. Ang DEFAULT_ADMIN_* group ang isa sa dalawang paraan para ayusin ito.
Sa pagsisimula, naghahanap ang Planka ng user na tumutugma sa DEFAULT_ADMIN_EMAIL. Kung wala nito, gumagawa ito ng user gamit ang password, display name, at username na nakatakda kasama nito. Sa mga kasunod na pagsisimula, ina-update rin nito ang tumutugmang account mula sa mga variable na ito. Kasama rito ang pag-reset ng password habang nakatakda pa ang DEFAULT_ADMIN_PASSWORD.
May ikalawang tungkulin ang DEFAULT_ADMIN_EMAIL na kadalasang nakalilito. Habang nakatakda ang variable, hindi maaaring baguhin sa interface ang pangalan, role, o email address ng account na tinutukoy nito. Hindi rin ito maaaring i-delete sa interface. Ito ang lock-out guard. Ito rin ang dahilan kung bakit hindi mo maaaring palitan ang pangalan o email address ng account na iyon sa UI. Alisin ang variable at i-restart ang Planka. Magiging ordinaryong admin ang account at maaari mo na itong i-edit gaya ng ibang account.
Ang password line ang kailangang pag-ingatan. Nababasang lahat ng nasa ilalim ng environment: ng sinumang maaaring magpatakbo ng docker inspect sa container. Kaya hindi dapat manatili roon nang permanente ang DEFAULT_ADMIN_PASSWORD. Mag-log in, tanggalin ang line na iyon, patakbuhin muli ang docker compose up -d, at pagkatapos ay palitan ang password sa interface.
Mas malinis na paraan ang hindi paggamit ng mga variable. I-comment out ang buong DEFAULT_ADMIN_* group, pagkatapos ay interactive na gawin ang account:
docker compose run --rm planka npm run db:create-admin-userHihingi ito ng email, password, display name, at optional na username. Isusulat nito agad ang user sa database. Hindi kailanman mapupunta ang password sa Compose file o sa configured environment ng container. Gamitin ang paraang ito kung higit sa isang tao ang may shell access sa VPS. Inuuna ng command na simulan ang Postgres dahil sa depends_on. Kaya gumagana ito kahit hindi pa kailanman napaandar ang stack.
Sa alinmang paraan, ikaw pa rin ang manu-manong mamamahala sa mga password ng Planka. Hanggang version 2.1.1, maaaring ipasa ng Community edition ang mga login sa isang OIDC provider gaya ng Authentik na tumatakbo bilang sarili mong single sign-on server. Ngunit sa version 2.2.0, na inilabas noong August 2026, inilipat ang OIDC at SSO sa PLANKA Pro. Ang idinagdag naman sa Community edition sa parehong release ay two-factor authentication (TOTP) para sa mga local account. Kaya kahit sa admin account lamang, i-enable ito.
Bakit nasisira ang mga login kapag hindi tugma ang BASE_URL sa hostname
Ang BASE_URL ang eksaktong address na tina-type ng mga user sa browser, kasama ang scheme at walang trailing slash. Para sa stack na ito, https://kanban.example.com ito. Ginagamit ng Planka ang value na ito sa pagbuo ng sarili nitong mga link at ng listahan ng mga pinapayagang WebSocket origin. Dahil dito, walang malinaw na error kapag mali ang BASE_URL. Sa halip, naglo-load ang page ngunit hindi ito natatapos mag-load.
Karaniwang nangyayari ito kapag kinopya mo ang upstream example, iniwan ang BASE_URL=http://localhost:3000, at binuksan ang site gamit ang HTTPS sa aktuwal mong domain. Naisusumite ang login form at tinatanggap ang iyong credentials. Ngunit hindi lumalabas ang board. Buksan ang developer console ng browser at makikita mong nabibigo ang mga request sa /socket.io/, dahil kumokonekta ang socket sa origin ng browser page ngunit pinapayagan ng origin restriction ng server ang origin na hinango mula sa BASE_URL.
Ang TRUST_PROXY=true ang kabilang bahagi ng parehong problema. Nasa likod ng Traefik ang Planka, kaya bawat request ay dumarating dito mula sa address ng proxy gamit ang plain HTTP sa loob ng Docker network. Kung wala ang TRUST_PROXY, binabalewala ng app ang mga header na X-Forwarded-Proto at X-Forwarded-For na itinatakda ng Traefik. Dahil dito, itinuturing nitong hindi secure ang koneksyon at itinuturing ang lahat ng client na iisang shared IP address. Kapag itinakda ito, binabasa ng app ang mga header na iyon at nagtutugma ang scheme nito sa browser.
Awtomatikong nagpo-proxy ang Traefik ng WebSockets nang walang karagdagang configuration. Isa ito sa mga dahilan kung bakit mainam itong gamitin dito. Sa nginx, kailangang ipasa ng proxy ang mga upgrade header na proxy_set_header Upgrade $http_upgrade at proxy_set_header Connection "upgrade". Kung hindi, makakakita ka ng parehong spinner na hindi natatapos, ngunit ibang sanhi ang pinagmulan. Maaaring ilagay ang mga ito sa pangkalahatang location / block. Maaari ring gumamit ng hiwalay na block para sa /socket.io, ngunit hindi ito kinakailangan.
Kung ililipat mo ang board sa bagong hostname, kailangan mong sabay na baguhin ang dalawang bagay: ang value ng BASE_URL at ang Traefik Host() rule. Kapag isa lamang ang binago mo, babalik ang spinner. Gumagana ang pag-serve sa Planka mula sa subpath gaya ng https://example.com/planka simula sa version 2.1.0, na inilabas noong March 2026. Sa mga mas lumang tag, bigyan ito ng sarili nitong subdomain.
Kung saan iniimbak ng Planka ang mga attachment at avatar
Iniimbak ng Planka 2 ang lahat ng ina-upload ng user sa iisang path sa loob ng container: /app/data. Nasa path na ito ang mga attachment, avatar ng user, at background image ng board. Gumamit ang Version 1 ng tatlong magkakahiwalay na directory. Kaya ang Compose file na kinopya mula sa mas lumang gabay ay nagmo-mount ng mga path na hindi na umiiral, at nawawala ang mount para sa tamang data.
Ang mount na ito ang nagdidikta kung mabubuhay ang board matapos ang upgrade o magkakaroon ng malaking abala. Idinedeklara ng Docker image ang /app/data bilang volume. Kapag hindi isinama ang mount sa Compose, napupunta ang mga upload sa isang anonymous volume. Pinananatili ito ng Compose sa karaniwang up recreation. Ngunit hindi ito awtomatikong ikinokonekta muli ng kasunod na down at up. Maayos na bumabalik ang board, naroon pa rin ang lahat ng card, ngunit patay ang bawat attachment link dahil tumutukoy pa rin ang mga row sa database sa mga file sa lumang volume.
Pinipigilan ito ng named volume sa Compose file sa itaas. Maaari ring gumamit ng bind mount. Mas madali nitong mai-back up ang mga file gamit ang karaniwang tools, ngunit may isang karagdagang hakbang. Tumatakbo ang Node process sa loob ng container bilang UID 1000. Kaya nagkakaroon ng permission error sa unang upload kapag root ang owner ng directory sa host:
sudo chown -R 1000:1000 /opt/planka/dataIpinaliliwanag sa bind mounts kumpara sa named volumes ang trade-off ng dalawang opsyon.
Kung lumampas ang laki ng mga attachment sa disk na kasama sa plan mo, maaaring sa S3-compatible storage na lang isulat ng Planka ang mga ito sa pamamagitan ng S3_ENDPOINT, S3_BUCKET, at mga katugmang key variable. Maaari itong tumuro sa isang hosted bucket o sa self-hosted na MinIO object store sa ibang machine. Magpasya bago mapuno ng team ang board, dahil kapag pinagana ang S3, inililipat nito ang pagbasa at pagsulat ng file sa backend na iyon nang hindi mina-migrate ang mga dati nang upload.
Simulan ang stack at tiyaking gumagana ito
docker compose pull
docker compose up -d
docker compose psDapat ipakita ng docker compose ps ang postgres bilang healthy at ang planka bilang running. Kung paulit-ulit na nagre-restart ang Planka, ang koneksyon sa database ang unang dapat suriin, hindi ang app.
docker compose logs -f plankaAng maayos na unang boot ay nagpapatakbo ng mga database migration, ngunit ang production configuration ay nagtatakda ng noShip: true at pinipigilan ang startup message na nag-uulat ng port 1337. Kumpirmahin kung pumasok nga ang schema sa pamamagitan ng direktang pagtatanong sa Postgres sa halip na umasa sa log:
docker compose exec postgres psql -U planka -d planka -c '\dt'Ang listahan ng table na may kasamang board at card ay nangangahulugang tumakbo ang mga migration. Ang "Did not find any relations" ay nangangahulugang hindi nakakonekta ang Planka, kaya ikumpara ang DATABASE_URL laban sa mga value ng POSTGRES_USER at POSTGRES_PASSWORD sa iyong .env.
Pagkatapos, suriin ang ruta mula sa iyong sariling machine, hindi mula sa VPS:
curl -I https://kanban.example.comAng HTTP/2 200 ay nangangahulugang may hawak na certificate ang Traefik at naaabot nito ang container. Ang 404 na galing sa Traefik ay nangangahulugang walang router na tumugma sa request: ang Host() rule ay hindi tumutugma sa hostname na hiniling mo, o hindi nakuha ng Traefik ang mga label. Ang 502 ay nangangahulugang tumugma ang router ngunit hindi maabot ng Traefik ang container, halimbawa dahil hindi ito naka-attach sa proxy network. Ngayon, buksan ang site at mag-log in gamit ang admin account.
Kumuha ng pg_dump bago ang bawat version bump
Dalawang magkahiwalay na store ang naglalaman ng iyong board, kaya dapat saklaw ng backup ang pareho: ang Postgres database at ang planka-data volume. I-dump ang database habang tumatakbo ang stack.
docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"Dini-disable ng -T ang default na pseudo-terminal allocation ng Compose, kaya nananatili ang dump sa isang plain output stream.
Sunod, ang mga upload. Hanapin muna ang aktuwal na pangalan ng volume, dahil nilalagyan ito ng Compose ng prefix na pangalan ng 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 .Kasama rin sa repository ng project ang docker-backup.sh at docker-restore.sh, at inilalagay ng opisyal na documentation ang mga ito sa nightly cron job. Ayos ang alinmang approach. Ang hindi ayos ay isang backup na hindi mo kailanman na-restore, kaya mag-restore ng isa sa isang scratch VPS at kumpirmahing makakapag-log in ka at makakapagbukas ng attachment. Lumilitaw ang parehong pares ng store sa bawat Compose app na tumatanggap ng mga upload, kaya kung ilalagay mo sa iisang box ang Chatwoot at ang iyong support desk sa hinaharap, magagamit pa rin ang routine na binuo mo rito na kaunting pagbabago lamang sa mga pangalan ng volume ang kailangan.
Patakbuhin ang dump kaagad bago ang bawat version change. Ang backup mula kagabi ay hindi kapareho ng backup na ginawa bago ang migration na malapit mo nang patakbuhin.
I-pin ang mga tag at basahin ang mga release note
Ang parehong image tag sa file na iyon ay sadyang naka-pin.
Ang ghcr.io/plankanban/planka:2.2.1 ay isang partikular na release, na kasalukuyang valid simula noong Oktubre 2026. Ang Community 2.3.0 ay inilabas noong Nobyembre 4, 2026, na may mga security fix, at inirerekomenda ng upstream ang pag-update. Sumunod ang Community 2.3.1 noong Nobyembre 5, 2026, na nag-aayos ng crash kapag nag-e-edit ng card description sa mga board na may member na walang username. Ang latest ay nagbabago tuwing may inilalathala ang upstream, kaya ang isang routine na docker compose pull ay maaaring magdala ng schema migration sa oras na hindi mo pinili. Basahin ang release notes bago mo baguhin ang numerong iyon, dahil doon nakasaad ang mga breaking change at security fix. Ang bersyong 2.0.3 ay inilathala bilang isang security release, na eksaktong uri ng impormasyon na gusto mong basahin sa halip na aksidenteng makuha. Ganoon din ang 2.2.1, na inilabas noong Agosto 2026: inayos nito ang isang path traversal flaw na nagpapahintulot sa isang naka-log in na user na magbasa ng mga arbitrary file sa mga instance na gumagamit ng local file storage, na siyang setup sa gabay na ito, at nakalista ang 2.1.1 at mas naunang bersyon bilang apektado. Kung galing ka sa 2.1.x, basahin muna ang mga note ng 2.2.0, dahil ang release na iyon ay nagde-deactivate ng mga user na nag-sign in lang sa pamamagitan ng SSO hanggang sa bigyan sila ng admin ng password at i-reactivate sila. Madali ang pag-pin dito dahil naglalathala ang upstream ng mga image, at kung saan walang inilalabas ang isang proyekto, utang mo rito ang parehong disiplina na may dagdag na hakbang, gaya ng sa openGym na binuo sa box mula sa isang naka-check out na git tag.
Ang postgres:16-alpine ay naka-pin sa isang major version dahil sa mas mabigat na dahilan. Isinusulat ng Postgres ang data directory nito sa format na nakatali sa major version, at tumatanggi ang server na buksan ang directory na isinulat ng ibang bersyon. Isulat ang postgres:latest, hayaang lumampas ang tag sa 16, at hindi magsisimula ang container. Ang image na 17, halimbawa, ay humihinto nang may:
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.Walang nawawala, at walang naaayos sa pag-restart. Ang paglipat sa isang bagong Postgres major ay nangangahulugan ng dump mula sa lumang bersyon at restore sa isang bagong data directory sa bago, isang pg_upgrade run, na nagko-convert ng data nang walang dump ngunit nangangailangan na ang luma at bagong server binary ay magkasamang available, o logical replication sa isang server na tumatakbo sa bagong bersyon na susundan ng switchover. Ang bawat ruta ay isang planadong migration, hindi side effect ng isang image pull; hinahayaan ng logical replication na patuloy na tumakbo ang lumang server habang humahabol ang bago.
Kung inililipat mo ang isang umiiral na Planka 1.x install sa halip na magsimula sa bago, ang upgrade na iyon ay may sariling dokumentadong pamamaraan sa dokumentasyon ng proyekto, at walang paraan pabalik sa bersyong 1 nang walang backup na kinuha nang maaga.
Mga failure mode at mga string na makikita mo
Paulit-ulit na nagre-restart ang Planka at binabanggit ng log ang database. Hindi tugma ang credentials sa DATABASE_URL sa Postgres environment. Tandaan na isang beses lamang inilalapat ang POSTGRES_PASSWORD kapag unang ini-initialize ang data directory, kaya walang mababago kung aayusin ang variable pagkatapos ng unang maling boot. Palitan ang password ng database role gamit ang ALTER ROLE upang tumugma sa naka-configure na password; opsyon lamang ang pag-remove sa db-data volume kung disposable ang installation at walang data na kailangang panatilihin.
Matagumpay ang login pero hindi kailanman naglo-load ang board. Hindi tugma ang BASE_URL sa address sa browser bar, kaya tinatanggihan ng server ang origin ng socket. Ipinapakita ng browser console ang mga request sa /socket.io/ na nagfa-fail.
Nabibigo ang uploads habang gumagana ang lahat ng iba pa. May bind mount na pagmamay-ari ng root. Patakbuhin ang sudo chown -R 1000:1000 sa host directory at i-restart ang container.
Nawala ang mga attachment pagkatapos ng upgrade. Hindi naka-attach ang /app/data sa orihinal na uploads volume. I-attach muli ang volume na iyon o i-restore ang mga file mula sa backup, pagkatapos ay gumamit ng named volume bago muling baguhin ang image tag.
Nagbabalik ang Traefik ng 404. Walang router na tumugma sa request: hindi tugma ang Host() rule sa iyong DNS record, o hindi nakarating sa Traefik ang mga label. Ipinapakita ng docker compose config ang mga label pagkatapos ng substitution; dito nagiging malinaw ang mga typo. Ang 502 naman ay nangangahulugang tumugma ang route pero hindi maabot ang container, kaya tiyaking nasa proxy network ito.
Hindi kailanman dumarating ang mga notification o webhook. Ipinapadaan ng Planka 2 ang mga outgoing HTTP request nito sa isang internal filter, at saklaw ng default block list ang localhost at postgres. Ang webhook na nakatuon sa localhost ay bina-block ayon sa disenyo, at kapag itinakda mo ang OUTGOING_ALLOWED_HOSTS, bina-block din ang bawat host na wala sa listahang iyon. Ituro ang webhook sa service name ng kabilang container, at idagdag ang pangalang iyon sa OUTGOING_ALLOWED_HOSTS kung gumagamit ka ng allow list, sa halip na alisin ang filter.
Kapag tumatakbo na ito, maliit na lamang ang operational load. Subaybayan ang release notes, at mag-dump ng database bago ang bawat upgrade. Awtomatikong maibabalik ng reboot ang stack dahil sa restart: unless-stopped, basta naka-enable sa boot ang Docker service mismo, at tinatalakay ng Mga Compose stack na bumabalik pagkatapos ng reboot ang mga sitwasyong hindi ito nangyayari.
FAQ
Bakit patuloy na naglo-load ang Planka pagkatapos kong mag-log in?
Tinanggap ang credentials, pero hindi tinanggap ang live connection. Binubuksan ng browser ang socket nito sa origin ng page, samantalang kinukuha ng Planka ang mga pinapayagang socket origin mula sa BASE_URL. Kaya kapag nanatili ang variable na iyon sa http://localhost:3000 habang ina-access mo ang site sa https://kanban.example.com, tinatanggihan ng server ang connection. Ipinapakita ng developer console ang mga nabigong request sa /socket.io/. Itakda ang BASE_URL sa eksaktong public address na walang trailing slash, idagdag ang TRUST_PROXY=true upang gamitin ng app ang X-Forwarded-Proto header mula sa reverse proxy, pagkatapos ay patakbuhin ang docker compose up -d.
Paano ko gagawin ang unang Planka admin user?
Simula sa version 1.13, walang awtomatikong ginagawang administrator. Maaari mong itakda ang DEFAULT_ADMIN_EMAIL kasama ang katugmang password, name, at username variables nito at simulan ang stack, o patakbuhin ang docker compose run --rm planka npm run db:create-admin-user at sagutin ang mga prompt. Mas ligtas ang interactive command sa shared server dahil hindi napupunta ang password sa configured environment ng container, kung saan mababasa ito ng docker inspect. Kapag nanatiling nakatakda ang DEFAULT_ADMIN_EMAIL pagkatapos ng setup, mapipigilan ang pagbabago sa name, role, at email address ng account na iyon, pati ang pagtanggal dito mula sa interface. Alisin ang DEFAULT_ADMIN_PASSWORD pagkatapos ng setup dahil kapag iniwan itong nakatakda, nire-reset nito ang password ng katugmang account sa pagsisimula.
Saan iniimbak ng Planka ang attachments at avatar?
Lahat ng uploaded file ay nasa ilalim ng /app/data sa loob ng container sa Planka 2, kabilang ang attachments, user avatar, at board background. I-mount ang path na iyon sa isang named volume. Kung walang explicit mount, anonymous volume ang ginagamit ng Docker image. Hindi ito awtomatikong muling ikinokonekta ng kasunod na docker compose up pagkatapos ng docker compose down. Maaari ring gumamit ng bind mount, pero tumatakbo ang Node process bilang UID 1000. Kaya patakbuhin ang sudo chown -R 1000:1000 sa host directory, kung hindi ay mabibigo ang uploads dahil sa permission error.
Gaano karaming RAM ang kailangan ng self-hosted Planka?
Inirerekomenda ng technical FAQ ng proyekto ang hindi bababa sa 2 GB RAM at 10 GB storage para sa maliliit na team. Ang default Docker deployment ay nagpapatakbo ng Node process, Postgres server na may backend process para sa bawat bukas na connection, at internal Squid proxy para sa pag-filter ng mga outgoing request. Patakbuhin ang docker stats --no-stream pagkatapos ng karaniwang linggo at gamitin ang sarili mong data sa pag-size. Mas tutukan ang disk kaysa memory dahil ang attachments ang patuloy na lumalaki.
Paano ko ia-upgrade ang Planka nang hindi nawawala ang data?
I-dump ang database at i-archive ang uploads volume kaagad bago ang upgrade, hindi gamit ang schedule kagabi. Gamitin ang docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql, at panatilihin ang -T upang i-disable ang pseudo-terminal allocation para sa redirected output. Basahin ang release notes para sa bawat bersiyong nilaktawan mo, palitan ang image tag ng partikular na release sa halip na latest, pagkatapos ay patakbuhin ang docker compose pull at docker compose up -d at i-monitor ang log para sa migration. Panatilihing naka-pin ang Postgres tag sa major version nito dahil tumatanggi ang server na buksan ang data directory na isinulat ng ibang major version.