Jinsi ya kujiendeshea Planka kwenye VPS na Docker
Jifunze kuweka Planka kwa kutumia Docker Compose, Postgres na Traefik. Pata suluhisho la hitilafu ya BASE_URL inayozuia watumiaji kuingia kwenye mfumo wako wa Kanban.
Unachopata kwa kujiendeshea Planka mwenyewe
Kujiendeshea Planka mwenyewe kunakupa timu yako ubao wa Kanban wenye kadi, orodha, na lebo ambazo watu tayari wanazijua kutoka Trello, zikifanya kazi kwenye VPS unayoimiliki. Hakuna mipaka ya idadi ya watumiaji na hakuna malipo kwa kila mtumiaji, kwa sababu gharama pekee ni seva. Mwongozo huu unaiweka kwa kutumia Docker Compose nyuma ya Traefik, huku ikitumia Postgres kwa ajili ya data na volume yenye jina maalum kwa kila faili wanayopakia watumiaji.
Planka 2 inatolewa chini ya leseni ya Fair Use ya mradi wenyewe, ambayo mradi huo unaielezea kama source-available badala ya open source. Kuiendesha kwa ajili ya miradi ya ndani ya shirika lako inaruhusiwa. Kuitoa kwa watu wengine kama huduma ya kibiashara inayohifadhiwa na wewe inahitaji leseni ya Pro au Enterprise.
Msomaji niliyemlenga ni timu ya watu wawili hadi watano wanaohama kutoka mpango wa bure wa Trello. Ikiwa bado unaamua ni ubao upi wa kutumia, soma ulinganisho wa njia mbadala za Trello zinazojiendesha. Mwongozo huu unachukulia kuwa uamuzi umeshafanyika na unashughulikia uwekaji pekee.
Unahitaji VPS inayoendesha Docker Engine na plugin ya Compose, na DNS A record inayoelekea huko. Pia unahitaji instance ya Traefik inayomalizia TLS (transport layer security) kwenye seva hiyo. Ikiwa Traefik haipo bado, sanidi reverse proxy ya Traefik mbele ya programu kadhaa za Compose kwanza, na usome misingi ya Docker Compose kwa VPS ikiwa faili iliyo hapa chini inaonekana ngeni.
Planka inahitaji VPS ya ukubwa gani?
FAQ ya kiufundi ya mradi huu inapendekeza angalau 2 GB ya RAM na 10 GB ya hifadhi kwa timu ndogo, kwa hivyo chukulia namba hizo kama kianzio badala ya kipimo kamili.
Kinachoendeshwa kwa uhalisia ni kidogo: mchakato mmoja wa Node.js unaohudumia API na frontend iliyojengwa, pamoja na seva ya Postgres inayohifadhi data, ambayo huendesha mchakato wa usimamizi pamoja na mchakato mmoja wa backend kwa kila muunganisho ulio wazi. Mchakato mdogo wa proxy pia huendeshwa ndani ya container ya Planka ili kuchuja maombi yake ya kutoka. Mpango wa 2 GB unalingana na pendekezo la RAM la mradi kwa timu ndogo. Ubao (board) ni jirani mwepesi, kwa hivyo ikiwa VPS hiyo hiyo inakusudiwa pia kuhifadhi hati za timu yako, panga ukubwa kwa ajili ya programu hiyo kwanza: kuendesha AFFiNE kama workspace ya mtindo wa Notion inahitaji takriban gigabytes mbili peke yake kabla Planka haijaomba chochote.
Panga ukubwa wa diski kabla ya kupanga ukubwa wa kumbukumbu, kwa sababu viambatisho ndivyo vinavyokua. Pima mfano wako mwenyewe badala ya kuamini aya hii:
docker stats --no-stream
docker system df -vAmri ya kwanza inachapisha kumbukumbu ya moja kwa moja na CPU kwa kila container. Ya pili inaonyesha nafasi inayotumiwa na kila volume. Chukua vipimo vyote viwili baada ya wiki ya kawaida ya kazi, siyo siku ya usakinishaji, kwa sababu ubao usio na shughuli haukuambii chochote kuhusu timu yako.
Andika faili ya Compose
Tengeneza saraka na uweke umiliki wake, ili usilazimike kuhariri faili hizi kupitia sudo.
sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/plankaTengeneza siri (secrets) kwenye faili ya .env kando ya faili ya Compose. Compose husoma faili hiyo kiotomatiki na kuingiza thamani zake.
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 imekusudiwa. Mfuatano wa hex una tarakimu na herufi a hadi f pekee, kwa hivyo hauwezi kuvunja mfuatano wa muunganisho wa DATABASE_URL unapoingizwa. Base64 ya kawaida inaweza kuwa na alama ya mkwaju, alama ya kujumlisha na alama ya sawa ya padding, lakini kamwe haina alama ya at; vibambo vyenye maana maalum katika URL ya muunganisho vinahitaji percent-encoding. Mfumo mpana zaidi umeelezwa katika kuepuka kuweka siri ndani ya faili ya Compose.
Sasa docker-compose.yml. Badilisha kanban.example.com na hostname yako mwenyewe katika sehemu zote mbili inapoonekana.
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:Maamuzi manne katika faili hiyo yanastahili ufafanuzi, kwa sababu ndiyo watu huyabadilisha na kisha kujuta.
- Hakuna kizuizi cha
ports:kwenye huduma ya Planka. Traefik hufikia kontena kupitia mtandao waproxy, kwa hivyo port 1337 haijachapishwa kamwe kwenye host. Kuichapisha kungepa mtu yeyote njia ya kukwepa proxy yako na cheti chako. loadbalancer.server.port=1337hutaja port iliyo ndani ya kontena. Planka husikiliza kwenye 1337, na mfano wa upstream huifikia kwenye 3000 kwa sababu hupanga port hiyo kwenye host. Hakuna mpangilio wa host hapa, kwa hivyo Traefik lazima iambiwe port ya kontena.condition: service_healthyhuambatana na healthcheck ya Postgres. Bila hiyo, Planka huanza kabla ya database kukubali miunganisho, hushindwa kwenye query yake ya kwanza na kuzima, jambo linaloonekana kama crash loop. Mbinu zake ziko katika Compose healthchecks na mpangilio wa kuanza.- Huduma ya database imepewa jina la
postgreskwa makusudi. Planka 2 huelekeza maombi yake ya nje kupitia kichujio cha ndani ambacho orodha yake ya kuzuia ya awali nilocalhost,postgres. Badilisha jina la huduma hiyo na utaondoa database yako kimyakimya kutoka kwenye orodha hiyo.
Thibitisha kuwa Compose inaweza kuona siri zako kabla ya kuanza chochote:
docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'Hiyo huchapisha faili ikiwa na thamani za .env zilizokwisha kuingizwa. Thamani tupu inamaanisha kuwa Compose haisomi faili ya .env, kwa kawaida kwa sababu unaendesha amri hiyo kutoka saraka tofauti.
Kazi halisi ya vigezo vya bootstrap vya msimamizi
Tangu toleo la Planka 1.13, hakuna msimamizi anayeundwa kiotomatiki, kwa hivyo database mpya haina mtu yeyote anayeweza kuingia. Kundi la DEFAULT_ADMIN_* ni mojawapo ya njia mbili za kurekebisha hali hiyo.
Wakati wa kuanza, Planka hutafuta mtumiaji anayelingana na DEFAULT_ADMIN_EMAIL. Ikiwa hakuna, huunda mmoja kwa kutumia nenosiri, jina la kuonyesha, na jina la mtumiaji lililowekwa sambamba na kigezo hicho. Katika kuanza kwa baadaye, pia husasisha akaunti inayolingana kutoka kwa vigezo hivi, ikiwa ni pamoja na kuweka upya nenosiri lake wakati DEFAULT_ADMIN_PASSWORD bado imewekwa.
DEFAULT_ADMIN_EMAIL hufanya kazi ya pili ambayo huwachanganya watu wengi. Wakati kigezo hiki kikiwa kimewekwa, akaunti inayotajwa na kigezo hicho haiwezi kubadilishiwa jina, jukumu, au anwani ya barua pepe, wala kufutwa kupitia kiolesura. Hiyo ni hatua ya kuzuia kufungiwa nje, na ndiyo sababu huwezi kubadili jina la akaunti hiyo au kubadilisha anwani yake ya barua pepe kwenye UI. Ondoa kigezo hicho na uanzishe upya huduma, na akaunti hiyo itakuwa msimamizi wa kawaida unayoweza kuhariri kama nyingine yoyote.
Mstari wa nenosiri ni ule unaopaswa kuwa mwangalifu nao. Chochote kilicho chini ya environment: kinaweza kusomwa na mtu yeyote anayeweza kuendesha docker inspect kwenye container, kwa hivyo DEFAULT_ADMIN_PASSWORD haipaswi kuwepo hapo kwa kudumu. Ingia kwenye mfumo, futa mstari huo, endesha docker compose up -d tena, kisha ubadilishe nenosiri lako kwenye kiolesura.
Njia safi zaidi ni kuruka vigezo hivi kabisa. Toa maoni (comment out) kwenye kundi zima la DEFAULT_ADMIN_*, kisha uunde akaunti hiyo kwa njia ya maingiliano (interactive):
docker compose run --rm planka npm run db:create-admin-userInakuuliza barua pepe, nenosiri, jina la kuonyesha, na jina la mtumiaji la hiari, na kuandika mtumiaji moja kwa moja kwenye database. Nenosiri haligusi faili ya Compose au mazingira yaliyosanidiwa ya container. Tumia njia hii ikiwa zaidi ya mtu mmoja ana uwezo wa kufikia shell ya VPS. Amri hii huanzisha Postgres kwanza kwa sababu ya depends_on, kwa hivyo inafanya kazi kwenye stack ambayo haijawahi kuwashwa.
Njia yoyote kati ya hizi inakuacha ukisimamia nywila za Planka kwa mkono. Hadi toleo la 2.1.1, toleo la Community liliweza kukabidhi maingizo kwa mtoa huduma wa OIDC kama vile Authentik inayofanya kazi kama seva yako ya single sign-on, lakini toleo la 2.2.0, lililotolewa Agosti 2026, lilihamishia OIDC na SSO kwenye PLANKA Pro. Kile ambacho toleo la Community lilipata katika toleo hilo hilo ni uthibitishaji wa hatua mbili (TOTP) kwa akaunti za ndani, kwa hivyo iwashe hiyo kwa akaunti ya msimamizi angalau.
Kwa nini BASE_URL huvunja uwezo wa kuingia (login) wakati hailingani na hostname
BASE_URL ni anwani kamili ambayo watu huandika kwenye kivinjari, ikiwa na scheme na bila slash mwishoni. Kwa stack hii, hiyo ni https://kanban.example.com. Planka hutengeneza viungo vyake vyenyewe na orodha yake ya WebSocket origins zinazoruhusiwa kutokana na thamani hiyo, jambo ambalo linamaanisha kuwa BASE_URL isiyo sahihi haikupi kosa la wazi. Badala yake, unapata ukurasa unaopakia lakini haumalizi kupakia.
Toleo la kawaida: unanakili mfano wa upstream, unaacha BASE_URL=http://localhost:3000 kama ulivyo, na unafikia tovuti kupitia HTTPS kwenye domain yako halisi. Fomu ya kuingia inatuma data na vitambulisho vyako vinakubaliwa. Ubao (board) haujitokezi. Fungua console ya msanidi wa kivinjari na utaona maombi kwenda /socket.io/ yakifeli, kwa sababu socket inaunganisha kwenye origin ya ukurasa wa kivinjari lakini kizuizi cha origin cha seva kinaruhusu origin inayotokana na BASE_URL.
TRUST_PROXY=true ni nusu nyingine ya tatizo hilo hilo. Planka inakaa nyuma ya Traefik, kwa hivyo kila ombi linaifikia kutoka kwa anwani ya proxy kupitia HTTP ya kawaida ndani ya Docker network. Bila TRUST_PROXY, programu hupuuza headers za X-Forwarded-Proto na X-Forwarded-For ambazo Traefik huweka, kwa hivyo inaamini kuwa muunganisho si salama na inachukulia kila mteja kama anwani moja ya IP inayoshirikiwa. Ikiwa imewekwa, programu husoma headers hizo na kukubaliana na kivinjari kuhusu scheme inayotumika.
Traefik hufanya proxy ya WebSockets bila usanidi wa ziada, ambayo ni sababu moja ya kuipendelea hapa. Kwenye nginx, proxy lazima isambaze upgrade headers, proxy_set_header Upgrade $http_upgrade na proxy_set_header Connection "upgrade", vinginevyo utapata spinner ile ile iliyokwama kwa sababu tofauti. Zinaweza kuwekwa kwenye block ya jumla ya location /; block tofauti kwa /socket.io pia inafanya kazi lakini si lazima.
Kuhamisha ubao kwenye hostname mpya baadaye kunamaanisha kubadilisha vitu viwili kwa pamoja: thamani ya BASE_URL na sheria ya Host() ya Traefik. Badilisha moja na usahau nyingine, na utarudi kwenye spinner. Kuhudumia Planka kutoka subpath kama https://example.com/planka hufanya kazi kuanzia toleo la 2.1.0 na kuendelea, lililotolewa Machi 2026. Kwenye tags za zamani, ipe subdomain yake yenyewe.
Mahali ambapo Planka huhifadhi viambatisho na avatari
Planka 2 huhifadhi kila kitu ambacho mtumiaji hupakia chini ya njia moja ndani ya kontena: /app/data. Viambatisho, avatari za watumiaji, na picha za usuli wa mbao (board background images) vyote hukaa hapo. Toleo la 1 lilitumia saraka tatu tofauti, kwa hivyo faili ya Compose iliyonakiliwa kutoka kwa mwongozo wa zamani huweka njia ambazo hazipo tena, na data inayokusudiwa kupandishwa (mount) haipo.
Kupandisha (mount) huko kimoja ndiko kunaleta tofauti kati ya mbao inayookoka uboreshaji na mchana mbaya. Picha ya Docker hutangaza /app/data kama volume, kwa hivyo kuacha kupandisha huko kwenye Compose huweka upakiaji kwenye volume isiyojulikana (anonymous volume). Compose huilinda wakati wa uundaji upya wa up, lakini down inayofuatiwa na up haiunganishi tena volume hiyo kiotomatiki. Mbao hurudi ikionekana sawa, kadi zote zipo, na kila kiungo cha kiambatisho kimekufa, kwa sababu safu za hifadhidata (database rows) bado zinaelekeza kwenye faili zilizomo kwenye volume ya zamani.
Volume yenye jina (named volume) katika faili ya Compose hapo juu huzuia hili. Bind mount pia hufanya kazi na hurahisisha kuhifadhi faili kwa kutumia zana za kawaida, lakini inahitaji hatua moja ya ziada. Mchakato wa Node ndani ya kontena huendeshwa kama UID 1000, kwa hivyo saraka ya mwenyeji (host directory) inayomilikiwa na root hutoa hitilafu ya ruhusa (permission error) wakati wa upakiaji wa kwanza:
sudo chown -R 1000:1000 /opt/planka/dataUlinganifu kati ya njia hizi mbili umeelezwa katika bind mounts dhidi ya named volumes.
Ikiwa viambatisho vitazidi nafasi ya diski kwenye mpango wako, Planka inaweza kuviandika kwenye hifadhi inayooana na S3, kupitia S3_ENDPOINT, S3_BUCKET na vigezo (variables) vya ufunguo vinavyolingana. Hiyo inaweza kuelekeza kwenye bucket inayohudumiwa na wengine au kwenye MinIO object store inayojiendesha yenyewe kwenye seva nyingine. Amua hili kabla ya timu kujaza mbao, kwa sababu kuwezesha S3 hubadilisha usomaji na uandikaji wa faili kwenda kwenye backend hiyo bila kuhamisha upakiaji uliopo.
Washa stack na uthibitishe kuwa ilifanya kazi
docker compose pull
docker compose up -d
docker compose psdocker compose ps inapaswa kuonyesha postgres ikiwa healthy na planka ikiwa running. Ikiwa Planka inaanza upya katika mfululizo, jambo la kwanza kukagua ni muunganisho wa database, si app.
docker compose logs -f plankaBoot ya kwanza yenye afya huendesha migrations za database, lakini configuration ya production huweka noShip: true na kuzima ujumbe wa kuanza unaoripoti port 1337. Thibitisha kuwa schema iliwekwa kweli kwa kuuliza Postgres moja kwa moja badala ya kuamini log:
docker compose exec postgres psql -U planka -d planka -c '\dt'Orodha ya tables inayojumuisha board na card inamaanisha migrations ziliendeshwa. “Did not find any relations” inamaanisha Planka haikuwahi kuunganishwa, kwa hiyo linganisha DATABASE_URL na thamani za POSTGRES_USER na POSTGRES_PASSWORD kwenye .env yako.
Kisha kagua route kutoka kwenye mashine yako mwenyewe, si kutoka VPS:
curl -I https://kanban.example.comHTTP/2 200 inamaanisha Traefik ina certificate na inafikia container. 404 inayotolewa na Traefik inamaanisha hakuna router iliyolingana na ombi: rule ya Host() hailingani na hostname uliyoomba, au Traefik haikupokea labels. 502 inamaanisha router ililingana lakini Traefik haikuweza kufikia container, kwa mfano kwa sababu haijaunganishwa kwenye network ya proxy. Sasa fungua tovuti na uingie kwa kutumia akaunti ya admin.
Chukua pg_dump kabla ya kila toleo jipya
Hifadhi mbili tofauti zinashikilia ubao wako, kwa hivyo backup lazima ihusishe zote mbili: database ya Postgres na volume ya planka-data. Fanya dump ya database wakati stack inaendelea kufanya kazi.
docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"-T huzima ugawaji wa pseudo-terminal wa kawaida wa Compose, na kuweka dump kwenye mkondo wa kawaida wa output.
Kisha upload. Tafuta jina halisi la volume kwanza, kwa sababu Compose huongeza jina la saraka ya mradi kama kiambishi awali.
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 .Mradi huu pia huja na docker-backup.sh na docker-restore.sh katika repository yake, na nyaraka rasmi huweka hizi kwenye cron job ya kila usiku. Njia yoyote kati ya hizi ni sawa. Kinachokosekana ni backup ambayo hujawahi kuirejesha, kwa hivyo rejesha moja kwenye VPS ya majaribio mara moja na uthibitishe kuwa unaweza kuingia na kufungua kiambatisho. Jozi hiyo hiyo ya hifadhi hujitokeza katika kila programu ya Compose inayokubali upload, kwa hivyo ukija kuweka Chatwoot kwenye seva moja na dawati lako la usaidizi, utaratibu unaojenga hapa utatumika kwa kubadilisha tu majina ya volume.
Endesha dump mara moja kabla ya kila mabadiliko ya toleo. Backup ya jana usiku si sawa na backup ya kabla ya migration unayotaka kufanya.
Bandika tags na soma release notes
Tags zote mbili za images kwenye faili hiyo zimebandikwa kwa makusudi.
ghcr.io/plankanban/planka:2.2.1 ni release maalum, ya sasa kufikia October 2026. Community 2.3.0 ilitolewa November 4, 2026, ikiwa na security fixes, na upstream inapendekeza kusasisha. Community 2.3.1 ilifuata November 5, 2026, ikirekebisha crash iliyotokea wakati wa kuhariri maelezo ya card kwenye boards yenye member asiye na username. latest hubadilika kila upstream inapochapisha release, kwa hiyo docker compose pull ya kawaida inaweza kuleta schema migration wakati ambao hukuuamua. Soma release notes kabla ya kubadilisha nambari hiyo, kwa sababu hapo ndipo breaking changes na security fixes zinaelezwa. Version 2.0.3 ilichapishwa kama security release, ambayo ndiyo aina ya mabadiliko unayopaswa kusoma badala ya kuipokea bila kutarajia. Hivyo pia 2.2.1, iliyotolewa August 2026: inarekebisha path traversal flaw iliyomwezesha user aliyeingia kusoma files zozote kwenye instances zinazotumia local file storage, ambayo ndiyo setup katika mwongozo huu, na advisory inaorodhesha 2.1.1 na zilizotangulia kuwa zilizoathiriwa. Ikiwa unatoka 2.1.x, soma notes za 2.2.0 kwanza, kwa sababu release hiyo huwazima users waliowahi kuingia kupitia SSO pekee hadi admin awape password na kuwawezesha tena. Kubandika tags ni rahisi hapa kwa sababu upstream huchapisha images, na pale project inaposhindwa kuchapisha images unapaswa kufuata nidhamu hiyo hiyo kwa hatua ya ziada, kama ilivyo kwa openGym iliyojengwa kwenye mashine kutoka kwenye git tag iliyocheckout.
postgres:16-alpine imebandikwa kwenye major version kwa sababu muhimu zaidi. Postgres huandika data directory katika format inayohusishwa na major version, na server hukataa kufungua directory iliyoandikwa na version tofauti. Andika postgres:latest, acha tag ipite 16, na container haitaanza. Image ya 17, kwa mfano, husimama ikiwa na:
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.Hakuna data inayopotea, na kuanzisha upya hakutatui tatizo hilo. Kuhamia kwenye major version mpya ya Postgres kunahitaji dump kutoka kwenye version ya zamani na restore kwenye data directory mpya katika version mpya, kuendesha pg_upgrade, ambayo hubadilisha data bila dump lakini inahitaji binaries za server ya zamani na mpya zipatikane pamoja, au kutumia logical replication kwenda kwenye server inayoendesha version mpya kisha kufanya switchover. Kila njia ni migration iliyopangwa, si matokeo ya pembeni ya kuvuta image; logical replication huruhusu server ya zamani kuendelea kufanya kazi wakati mpya inasawazisha data.
Ikiwa unahamisha install iliyopo ya Planka 1.x badala ya kuanza upya, upgrade hiyo ina utaratibu wake ulioandikwa kwenye nyaraka za project, na hakuna njia ya kurudi kwenye version 1 bila backup iliyochukuliwa mapema.
Njia za hitilafu na ujumbe utakaouona
Planka inajianzisha upya mara kwa mara na logi inataja database. Vitambulisho vilivyopo kwenye DATABASE_URL havilingani na mazingira ya Postgres. Kumbuka kuwa POSTGRES_PASSWORD hutumika tu wakati saraka ya data inapoanzishwa kwa mara ya kwanza, kwa hivyo kurekebisha variable hiyo baada ya boot ya kwanza iliyofeli hakutabadilisha chochote. Badilisha nenosiri la role ya database kwa kutumia ALTER ROLE ili ilingane na nenosiri lililowekwa; kufuta volume ya db-data ni chaguo tu kwa usakinishaji wa muda ambao hauna data ya kuhifadhi.
Kuingia kwenye mfumo kunafanikiwa lakini ubao haufunguki. BASE_URL hailingani na anwani iliyo kwenye bar ya kivinjari, kwa hivyo seva inakataa asili ya socket. Console ya kivinjari inaonyesha maombi yanayofeli kuelekea /socket.io/.
Upakiaji wa faili unafeli wakati kila kitu kingine kinafanya kazi. Bind mount inamilikiwa na root. Tekeleza sudo chown -R 1000:1000 kwenye saraka ya host na uanzishe upya container.
Viambatisho vimepotea baada ya upgrade. /app/data haikuunganishwa kwenye volume asilia ya uploads. Unganisha tena volume hiyo au rudisha faili kutoka kwenye backup, kisha tumia named volume kabla ya kugusa image tag tena.
Traefik inarudisha 404. Hakuna router iliyolingana na ombi hilo: sheria ya Host() hailingani na DNS record yako, au lebo hazikufika kwa Traefik. docker compose config inaonyesha lebo baada ya substitution, ambapo makosa ya uchapaji huwa dhahiri. 502 inamaanisha kuwa njia ililingana lakini container haikuweza kufikiwa, kwa hivyo hakikisha iko kwenye mtandao wa proxy.
Arifa au webhooks hazifiki. Planka 2 hutuma maombi yake ya nje ya HTTP kupitia kichujio cha ndani, na orodha ya kuzuia ya kawaida inahusu localhost na postgres. Webhook inayolenga localhost imezuiwa kwa makusudi, na mara tu unapoweka OUTGOING_ALLOWED_HOSTS, kila host isiyo kwenye orodha hiyo inazuiwa pia. Elekeza webhook kwenye jina la huduma la container nyingine, na ongeza jina hilo kwenye OUTGOING_ALLOWED_HOSTS ikiwa unatumia orodha ya kuruhusu, badala ya kuondoa kichujio.
Mara tu inapofanya kazi, mzigo wa uendeshaji ni mdogo. Fuatilia maelezo ya toleo (release notes), na fanya dump ya database kabla ya kila upgrade. Reboot inarudisha stack yenyewe kwa sababu ya restart: unless-stopped, mradi huduma ya Docker yenyewe imewezeshwa wakati wa boot, na Compose stacks zinazorudi baada ya reboot inashughulikia hali ambazo haifanyi hivyo.
FAQ
Kwa nini Planka inapakia bila mwisho baada ya kuingia?
Vitambulisho vilikubaliwa lakini muunganisho wa moja kwa moja (live connection) haukukubaliwa. Kivinjari hufungua socket yake kuelekea asili ya ukurasa, wakati Planka hupata asili za socket zinazoruhusiwa kutoka BASE_URL, kwa hivyo kuacha kigezo hicho kwenye http://localhost:3000 wakati unafikia tovuti hiyo kupitia https://kanban.example.com husababisha seva kukataa muunganisho. Dashibodi ya msanidi programu inaonyesha maombi yanayofeli kuelekea /socket.io/. Weka BASE_URL kwenye anwani kamili ya umma bila alama ya mkwaju (slash) mwishoni, ongeza TRUST_PROXY=true ili programu iheshimu header ya X-Forwarded-Proto kutoka kwa reverse proxy yako, kisha endesha docker compose up -d.
Ninawezaje kuunda mtumiaji wa kwanza wa admin wa Planka?
Tangu toleo la 1.13 hakuna msimamizi anayeundwa kiotomatiki. Aidha weka DEFAULT_ADMIN_EMAIL pamoja na vigezo vyake vinavyolingana vya nenosiri, jina na jina la mtumiaji kisha uanzishe stack, au endesha docker compose run --rm planka npm run db:create-admin-user na ujibu maelekezo yanayojitokeza. Amri ya maingiliano (interactive command) ni salama zaidi kwenye seva inayoshirikiwa, kwa sababu nenosiri haliingii kamwe kwenye mazingira yaliyosanidiwa ya container ambapo docker inspect inaweza kulisoma. Kuacha DEFAULT_ADMIN_EMAIL kikiwa kimewekwa baada ya hapo huzuia mabadiliko ya jina, jukumu na anwani ya barua pepe ya akaunti hiyo, na huzuia kufutwa kwake kutoka kwenye interface. Ondoa DEFAULT_ADMIN_PASSWORD baada ya usanidi, kwa sababu kukiacha kikiwa kimewekwa kutabadilisha nenosiri la akaunti inayolingana kila wakati seva inapoanza.
Planka huhifadhi wapi viambatisho na avatar?
Faili zote zilizopakiwa hukaa chini ya /app/data ndani ya container katika Planka 2, ikijumuisha viambatisho, avatar za watumiaji na picha za nyuma za ubao (board backgrounds). Mount njia hiyo kwenye named volume. Bila mount ya wazi, picha ya Docker hutumia anonymous volume, ambayo docker compose up inayofuata haiunganishi kiotomatiki baada ya docker compose down. Bind mount pia hufanya kazi, lakini mchakato wa Node huendeshwa kama UID 1000, kwa hivyo endesha sudo chown -R 1000:1000 kwenye saraka ya host au upakiaji utafeli kwa hitilafu ya ruhusa (permission error).
Planka inayojiendesha (self-hosted) inahitaji RAM kiasi gani?
FAQ ya kiufundi ya mradi huu inapendekeza angalau 2 GB ya RAM na 10 GB ya hifadhi kwa timu ndogo. Utekelezaji wa kawaida wa Docker huendesha mchakato wa Node, seva ya Postgres yenye mchakato wa backend kwa kila muunganisho ulio wazi, na Squid proxy ya ndani kwa ajili ya kuchuja maombi yanayotoka. Endesha docker stats --no-stream baada ya wiki ya kawaida na upime ukubwa kulingana na namba zako mwenyewe. Fuatilia diski kwa karibu zaidi kuliko kumbukumbu, kwa sababu viambatisho ndivyo vinavyokua.
Ninawezaje kuboresha (upgrade) Planka bila kupoteza data?
Hifadhi nakala ya database na uhifadhi volume ya uploads mara moja kabla ya kuboresha, si kulingana na ratiba ya jana usiku. Tumia docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql, huku ukihifadhi -T ili kulemaza utengaji wa pseudo-terminal kwa matokeo yaliyoelekezwa kwingine. Soma maelezo ya toleo (release notes) kwa kila toleo unaloruka, badilisha image tag kuwa toleo maalum badala ya latest, kisha endesha docker compose pull na docker compose up -d na ufuatilie log kwa ajili ya migration. Acha tag ya Postgres ikiwa imefungwa kwenye toleo lake kuu (major version), kwa sababu seva hukataa kufungua saraka ya data iliyoandikwa na toleo tofauti kuu.