SSD Nodes Learn Hosting plans →
Gidsen Matt ConnorDoor Matt Connor

Planka zelf hosten met Docker Compose: handleiding

Implementeer Planka op uw eigen VPS met Docker Compose, Postgres en Traefik. Leer hoe u de admin variabelen instelt en de BASE_URL fout voorkomt die inloggen blokkeert.

Wat u krijgt door Planka zelf te hosten

Door Planka zelf te hosten, beschikt uw team over een Kanban-bord met het model van kaarten, lijsten en labels dat bekend is van Trello, draaiend op een VPS die u beheert. Er zijn geen limieten voor het aantal gebruikers en geen facturatie per gebruiker, aangezien de enige kosten de server zijn. Deze handleiding implementeert de software met Docker Compose achter Traefik, waarbij Postgres wordt gebruikt voor de data en een named volume voor elk bestand dat gebruikers uploaden.

Planka 2 wordt uitgebracht onder de eigen Fair Use License van het project, die door het project wordt omschreven als source-available in plaats van open source. Het draaien van de software voor de interne projecten van uw eigen organisatie is toegestaan. Het aanbieden van de software aan derden als een commerciële hosted service vereist een Pro- of Enterprise-licentie.

De doelgroep voor deze handleiding is een team van twee tot vijf personen dat de gratis versie van Trello verlaat. Als u nog beslist welk bord u wilt gebruiken, lees dan eerst de vergelijking van zelf-gehoste Trello-alternatieven. Deze handleiding gaat ervan uit dat de keuze al is gemaakt en behandelt alleen de implementatie.

U heeft een VPS nodig waarop Docker Engine met de Compose-plugin draait, en een DNS A-record dat naar deze server wijst. U heeft ook een Traefik-instantie nodig die al TLS (transport layer security) op die server afhandelt. Als Traefik nog niet aanwezig is, zet dan eerst een Traefik reverse proxy voor meerdere Compose-apps op, en lees de basisprincipes van Docker Compose voor een VPS als het onderstaande bestand onbekend voorkomt.

Hoeveel VPS-capaciteit heeft Planka nodig?

De technische FAQ van het project adviseert minimaal 2 GB RAM en 10 GB opslag voor kleine teams; beschouw deze getallen als een startpunt en niet als een definitieve maatstaf.

Wat er daadwerkelijk draait is beperkt: één Node.js-proces dat de API en de gebouwde frontend serveert, en een Postgres-server die de data bevat. Deze laatste voert een supervisieproces uit plus één backend-proces voor elke open verbinding. Een klein proxy-proces draait eveneens binnen de Planka-container om uitgaande verzoeken te filteren. Een 2 GB-abonnement komt overeen met de RAM-aanbeveling van het project voor kleine teams. Een bord is een lichte buur; als dezelfde VPS ook de documenten van uw team moet huisvesten, bepaal dan eerst de grootte voor die applicatie: het draaien van AFFiNE als een Notion-stijl werkruimte vereist op zichzelf al een paar gigabyte voordat Planka om middelen vraagt.

Bepaal de schijfgrootte voordat u het geheugen dimensioneert, aangezien bijlagen het onderdeel zijn dat groeit. Meet uw eigen instantie in plaats van op deze paragraaf te vertrouwen:

docker stats --no-stream
docker system df -v

De eerste opdracht toont het actuele geheugen- en CPU-gebruik per container. De tweede laat zien hoeveel ruimte elk volume in beslag neemt. Neem beide metingen na een normale werkweek, niet op de dag van installatie, omdat een inactief bord niets zegt over het gebruik door uw team.

Het Compose-bestand schrijven

Maak de directory aan en neem het eigendom ervan over, zodat u deze bestanden nooit via sudo hoeft te bewerken.

sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/planka

Genereer de secrets in een .env-bestand naast het Compose-bestand. Compose leest dit bestand automatisch en vervangt de waarden.

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 .env

openssl rand -hex is een bewuste keuze. Een hex-string bevat alleen cijfers en de letters a tot f, waardoor deze de DATABASE_URL-verbindingsreeks waarin deze wordt geplakt niet kan verbreken. Standaard Base64 kan een slash, plusteken en padding-gelijkheidsteken bevatten, maar nooit een apenstaartje; tekens met een speciale betekenis in een verbindings-URL vereisen percent-encoding. Het bredere patroon wordt behandeld in geheimen buiten het Compose-bestand houden.

Voer nu docker-compose.yml uit. Vervang kanban.example.com door uw eigen hostnaam op beide plaatsen waar deze voorkomt.

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:

Vier beslissingen in dat bestand zijn een toelichting waard, omdat dit de punten zijn die mensen wijzigen en waar ze later spijt van krijgen.

  • Er is geen ports:-blok aanwezig bij de Planka-service. Traefik bereikt de container via het proxy-netwerk, dus poort 1337 wordt nooit gepubliceerd op de host. Publicatie zou iedereen een manier geven om uw proxy en uw certificaat te omzeilen.
  • loadbalancer.server.port=1337 benoemt de poort binnen de container. Planka luistert op 1337, en het upstream-voorbeeld bereikt het alleen op 3000 omdat het de poort naar de host mapt. Hier is geen host-mapping, dus moet Traefik de containerpoort weten.
  • condition: service_healthy hoort bij de Postgres-healthcheck. Zonder dit start Planka voordat de database verbindingen accepteert, faalt de eerste query en sluit het programma af, wat eruitziet als een crash-loop. De werking wordt uitgelegd in Compose healthchecks en opstartvolgorde.
  • De databaseservice is bewust postgres genoemd. Planka 2 routeert zijn eigen uitgaande verzoeken via een intern filter waarvan de standaard blocklist localhost,postgres is. Hernoem de service en u verwijdert stilletjes uw database uit die lijst.

Controleer of Compose uw secrets kan zien voordat u iets start:

docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'

Dit drukt het bestand af met de reeds ingevulde .env-waarden. Een lege waarde betekent dat Compose het .env-bestand niet leest, meestal omdat u het commando vanuit een andere directory uitvoert.

Wat de admin bootstrap-variabelen precies doen

Sinds Planka 1.13 wordt er niet langer automatisch een beheerder voor u aangemaakt. Een nieuwe database bevat daarom standaard geen gebruikers die kunnen inloggen. De DEFAULT_ADMIN_*-groep is een van de twee manieren om dit op te lossen.

Bij het opstarten controleert Planka of er een gebruiker bestaat die overeenkomt met DEFAULT_ADMIN_EMAIL. Als deze niet bestaat, wordt er een aangemaakt met het wachtwoord, de weergavenaam en de gebruikersnaam die daarbij zijn opgegeven. Bij latere starts werkt Planka een overeenkomend account bij op basis van deze variabelen, inclusief het opnieuw instellen van het wachtwoord zolang DEFAULT_ADMIN_PASSWORD is ingesteld.

DEFAULT_ADMIN_EMAIL vervult een tweede functie die vaak voor verwarring zorgt. Zolang deze variabele is ingesteld, kunnen de naam, rol of het e-mailadres van het betreffende account niet via de interface worden gewijzigd of verwijderd. Dit is een beveiliging tegen buitensluiting; dit is tevens de reden waarom u dat account niet kunt hernoemen of het e-mailadres ervan kunt aanpassen in de UI. Verwijder de variabele en herstart de container; het account wordt daarna een normale beheerder die u als elke andere gebruiker kunt bewerken.

Wees voorzichtig met de wachtwoordregel. Alles onder environment: is leesbaar voor iedereen die docker inspect op de container kan uitvoeren, dus DEFAULT_ADMIN_PASSWORD hoort daar niet permanent te staan. Log in, verwijder die regel, voer docker compose up -d opnieuw uit en wijzig daarna uw wachtwoord in de interface.

De schonere methode is om de variabelen volledig over te slaan. Zet de gehele DEFAULT_ADMIN_*-groep in commentaar en maak het account interactief aan:

docker compose run --rm planka npm run db:create-admin-user

Dit script vraagt om een e-mailadres, wachtwoord, weergavenaam en een optionele gebruikersnaam, en schrijft de gebruiker direct naar de database. Het wachtwoord komt hierbij nooit in het Compose-bestand of de geconfigureerde omgeving van de container terecht. Gebruik deze methode als meerdere personen shell-toegang hebben tot de VPS. Het commando start eerst Postgres vanwege depends_on, waardoor het ook werkt op een stack die nog nooit eerder is opgestart.

Beide methoden vereisen dat u Planka-wachtwoorden handmatig beheert. Tot versie 2.1.1 kon de Community-editie inloggegevens overdragen aan een OIDC-provider zoals Authentik als uw eigen single sign-on server, maar versie 2.2.0, uitgebracht in augustus 2026, heeft OIDC en SSO verplaatst naar PLANKA Pro. Wat de Community-editie in dezelfde release heeft gekregen, is tweefactorauthenticatie (TOTP) voor lokale accounts; schakel dit in ieder geval in voor het beheerdersaccount.

Waarom BASE_URL inlogproblemen veroorzaakt wanneer deze niet overeenkomt met de hostnaam

BASE_URL is het exacte adres dat gebruikers in de browser typen, inclusief het protocol en zonder afsluitende slash. Voor deze stack is dat https://kanban.example.com. Planka genereert zijn eigen links en de lijst met toegestane WebSocket-origins op basis van deze waarde. Een onjuiste BASE_URL resulteert daarom niet in een duidelijke foutmelding. U krijgt een pagina die wel laadt, maar waarbij het laden nooit wordt voltooid.

De veelvoorkomende situatie: u kopieert het upstream-voorbeeld, laat BASE_URL=http://localhost:3000 staan en bezoekt de site via HTTPS op uw eigen domein. Het inlogformulier wordt verzonden en uw inloggegevens worden geaccepteerd. Het bord verschijnt echter nooit. Open de developer console van uw browser en u zult zien dat verzoeken aan /socket.io/ falen. Dit komt doordat de socket verbinding maakt met de origin van de browserpagina, terwijl de origin-restrictie van de server de origin toestaat die is afgeleid van BASE_URL.

TRUST_PROXY=true is de andere helft van hetzelfde probleem. Planka bevindt zich achter Traefik, waardoor elk verzoek het bereikt vanaf het adres van de proxy via onversleuteld HTTP binnen het Docker-netwerk. Zonder TRUST_PROXY negeert de applicatie de X-Forwarded-Proto en X-Forwarded-For headers die Traefik instelt. Hierdoor denkt de applicatie dat de verbinding onveilig is en behandelt het elke client als één gedeeld IP-adres. Wanneer deze optie is ingeschakeld, leest de applicatie de headers en stemt het protocol overeen met dat van de browser.

Traefik proxiet WebSockets zonder extra configuratie, wat een reden is om hier de voorkeur aan te geven. Bij nginx moet de proxy de upgrade-headers, proxy_set_header Upgrade $http_upgrade en proxy_set_header Connection "upgrade", doorsturen; anders krijgt u hetzelfde vastlopende laadscherm door een andere oorzaak. Deze kunnen in het algemene location /-blok worden geplaatst; een apart blok voor /socket.io werkt ook, maar is niet vereist.

Het verplaatsen van het bord naar een nieuwe hostnaam vereist later het gelijktijdig aanpassen van twee zaken: de BASE_URL-waarde en de Traefik Host()-regel. Wijzigt u de een en vergeet u de ander, dan keert het laadprobleem terug. Het serveren van Planka vanaf een subpad zoals https://example.com/planka werkt vanaf versie 2.1.0, uitgebracht in maart 2026. Gebruik bij oudere tags een eigen subdomein.

Waar Planka bijlagen en avatars opslaat

Planka 2 slaat alles wat een gebruiker uploadt op onder één pad in de container: /app/data. Bijlagen, gebruikersavatars en achtergrondafbeeldingen voor borden bevinden zich hier allemaal. Versie 1 gebruikte drie afzonderlijke mappen, waardoor een Compose-bestand dat is gekopieerd uit een oudere handleiding paden koppelt die niet meer bestaan, en de beoogde datakoppeling ontbreekt.

Die ene koppeling is het verschil tussen een bord dat een upgrade overleeft en een verloren middag. De Docker-image declareert /app/data als een volume, dus het weglaten van de koppeling in Compose plaatst uploads in een anoniem volume. Compose behoudt dit tijdens een normale up-recreatie, maar een latere down gevolgd door up koppelt dit niet automatisch opnieuw. Het bord ziet er bij terugkomst goed uit, de kaarten zijn aanwezig, maar elke link naar een bijlage is defect, omdat de databaserijen nog steeds verwijzen naar bestanden in het oude volume.

Het benoemde volume in het bovenstaande Compose-bestand voorkomt dit. Een bind mount werkt ook en maakt het eenvoudiger om de bestanden met standaardtools te back-uppen, maar dit vereist één extra stap. Het Node-proces in de container draait als UID 1000, dus een hostmap die eigendom is van root geeft een toegangsrechtenfout bij de eerste upload:

sudo chown -R 1000:1000 /opt/planka/data

De afweging tussen beide wordt besproken in bind mounts versus benoemde volumes.

Als bijlagen meer schijfruimte in beslag nemen dan uw abonnement toestaat, kan Planka deze wegschrijven naar S3-compatibele opslag via S3_ENDPOINT, S3_BUCKET en de bijbehorende sleutelvariabelen. Dit kan verwijzen naar een gehoste bucket of naar een zelfgehoste MinIO object store op een andere machine. Beslis dit voordat het team het bord vult, omdat het inschakelen van S3 het lezen en schrijven van bestanden naar die backend verplaatst zonder bestaande uploads te migreren.

Start de stack en controleer of deze werkt

docker compose pull
docker compose up -d
docker compose ps

docker compose ps hoort postgres weer te geven als healthy en planka als running. Als Planka in een lus blijft herstarten, is de databaseverbinding het eerste wat u moet controleren, niet de applicatie zelf.

docker compose logs -f planka

Een gezonde eerste opstart voert de databasemigraties uit, maar de productieconfiguratie stelt noShip: true in en onderdrukt het opstartbericht dat poort 1337 rapporteert. Bevestig dat het schema daadwerkelijk is aangemaakt door dit rechtstreeks aan Postgres te vragen in plaats van op het logboek te vertrouwen:

docker compose exec postgres psql -U planka -d planka -c '\dt'

Een tabeloverzicht dat board en card bevat, betekent dat de migraties zijn uitgevoerd. "Did not find any relations" betekent dat Planka nooit verbinding heeft gemaakt; vergelijk in dat geval DATABASE_URL met de POSTGRES_USER en POSTGRES_PASSWORD waarden in uw .env.

Controleer vervolgens de route vanaf uw eigen machine, niet vanaf de VPS:

curl -I https://kanban.example.com

HTTP/2 200 betekent dat Traefik een certificaat bezit en de container bereikt. Een 404-foutmelding van Traefik betekent dat geen enkele router overeenkwam met het verzoek: de Host()-regel komt niet overeen met de hostnaam die u heeft opgegeven, of Traefik heeft de labels niet opgepikt. Een 502-foutmelding betekent dat de router wel overeenkwam, maar dat Traefik de container niet kon bereiken, bijvoorbeeld omdat deze niet is gekoppeld aan het proxy-netwerk. Open nu de site en log in met het beheerdersaccount.

Maak een pg_dump voor elke versie-update

Twee afzonderlijke opslaglocaties bevatten uw board, dus een back-up moet beide dekken: de Postgres-database en het planka-data-volume. Maak een dump van de database terwijl de stack actief is.

docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"

De -T schakelt de standaard pseudo-terminaltoewijzing van Compose uit, waardoor de dump op een eenvoudige outputstream blijft staan.

Vervolgens de uploads. Zoek eerst de werkelijke volumenaam, omdat Compose deze voorziet van een voorvoegsel met de naam van de projectmap.

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 .

Het project levert ook docker-backup.sh en docker-restore.sh in de repository, en de officiële documentatie adviseert deze via een dagelijkse cron-job uit te voeren. Beide methoden zijn prima. Wat niet prima is, is een back-up die u nog nooit heeft teruggezet. Zet er daarom een terug op een test-VPS en bevestig dat u kunt inloggen en een bijlage kunt openen. Hetzelfde paar opslaglocaties komt voor in elke Compose-app die uploads accepteert. Als u later Chatwoot op dezelfde server als uw supportdesk plaatst, is de routine die u hier opbouwt overdraagbaar met nauwelijks meer wijzigingen dan de volumenaam.

Voer de dump direct uit voor elke versie-update. Een back-up van gisteravond is niet hetzelfde als een back-up van vóór de migratie die u op het punt staat uit te voeren.

Zet de tags vast en lees de release notes

Beide image-tags in dat bestand zijn bewust vastgezet.

ghcr.io/plankanban/planka:2.2.1 is een specifieke release, actueel per oktober 2026. Community 2.3.0 werd uitgebracht op 4 november 2026 met beveiligingsoplossingen, en de ontwikkelaars raden aan om bij te werken. Community 2.3.1 volgde op 5 november 2026 en loste een crash op bij het bewerken van kaartbeschrijvingen op borden met een lid zonder gebruikersnaam. latest verschuift telkens wanneer de ontwikkelaars een nieuwe versie publiceren, waardoor een routine-docker compose pull een schemamigratie kan doorvoeren op een moment dat u niet heeft gekozen. Lees de release notes voordat u dat nummer wijzigt, want daar worden ingrijpende wijzigingen en beveiligingsoplossingen beschreven. Versie 2.0.3 werd gepubliceerd als een beveiligingsrelease; dit is precies het soort informatie dat u wilt lezen in plaats van dat het onbedoeld wordt toegepast. Dat gold ook voor 2.2.1, uitgebracht in augustus 2026: deze loste een path traversal-kwetsbaarheid op waarmee een ingelogde gebruiker willekeurige bestanden kon lezen op instanties die lokale bestandsopslag gebruiken (de configuratie in deze handleiding). De advieslijst vermeldt 2.1.1 en eerder als getroffen versies. Als u overstapt vanaf 2.1.x, lees dan eerst de 2.2.0-aantekeningen, omdat die release gebruikers deactiveert die alleen via SSO inlogden, totdat een beheerder hen een wachtwoord geeft en opnieuw activeert. Vastzetten is hier eenvoudig omdat de ontwikkelaars überhaupt images publiceren. Waar een project geen images levert, bent u dezelfde discipline verschuldigd met een extra stap, zoals bij openGym gebouwd op de machine vanuit een uitgecheckte git-tag.

postgres:16-alpine is om een zwaardere reden vastgezet op een hoofdversie. Postgres schrijft zijn datamap in een formaat dat gekoppeld is aan de hoofdversie, en de server weigert een map te openen die door een andere versie is geschreven. Schrijf postgres:latest, laat de tag voorbij 16 gaan, en de container zal niet starten. De 17-image stopt bijvoorbeeld met:

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.

Er gaat niets verloren en het probleem wordt ook niet opgelost door simpelweg te herstarten. Overstappen naar een nieuwe Postgres-hoofdversie betekent een dump maken van de oude versie en een restore uitvoeren in een nieuwe datamap op de nieuwe versie, een pg_upgrade-run uitvoeren (die de data converteert zonder dump, maar waarvoor de oude en nieuwe server-binaries tegelijk beschikbaar moeten zijn), of logische replicatie naar een server die de nieuwe versie draait, gevolgd door een switchover. Elke route is een geplande migratie, geen bijwerking van een image-pull; logische replicatie laat de oude server draaien terwijl de nieuwe server bijwerkt.

Als u een bestaande Planka 1.x-installatie verplaatst in plaats van een nieuwe start, heeft die upgrade een eigen gedocumenteerde procedure in de projectdocumentatie, en is er geen weg terug naar versie 1 zonder een vooraf gemaakte back-up.

Foutmodi en de meldingen die u zult zien

Planka start in een lus en het logboek noemt de database. De inloggegevens in DATABASE_URL komen niet overeen met de Postgres-omgeving. Let op: POSTGRES_PASSWORD wordt alleen toegepast wanneer de datamap voor het eerst wordt geïnitialiseerd. Het aanpassen van de variabele na een mislukte eerste opstart verandert dus niets. Wijzig het wachtwoord van de database-rol met ALTER ROLE zodat dit overeenkomt met het geconfigureerde wachtwoord; het verwijderen van het db-data-volume is alleen een optie voor een tijdelijke installatie zonder gegevens die behouden moeten blijven.

Inloggen lukt, maar het board laadt niet. BASE_URL komt niet overeen met het adres in de browserbalk, waardoor de server de oorsprong van de socket weigert. De browserconsole toont mislukte verzoeken aan /socket.io/.

Uploads mislukken terwijl al het andere werkt. Een bind mount is eigendom van root. Voer sudo chown -R 1000:1000 uit op de hostmap en herstart de container.

Bijlagen zijn verdwenen na een upgrade. /app/data was niet gekoppeld aan het oorspronkelijke uploads-volume. Koppel dat volume opnieuw of zet de bestanden terug vanuit een back-up en gebruik daarna een named volume voordat u de image-tag opnieuw wijzigt.

Traefik geeft een 404. Geen enkele router kwam overeen met het verzoek: de Host()-regel komt niet overeen met uw DNS-record, of de labels hebben Traefik nooit bereikt. docker compose config toont de labels na substitutie; hier worden typefouten zichtbaar. Een 502 betekent dat de route wel overeenkwam, maar dat de container niet bereikbaar was. Controleer of deze zich op het proxy-netwerk bevindt.

Meldingen of webhooks komen nooit aan. Planka 2 verstuurt uitgaande HTTP-verzoeken via een intern filter en de standaard blokkeerlijst omvat localhost en postgres. Een webhook gericht op localhost wordt opzettelijk geblokkeerd, en zodra u OUTGOING_ALLOWED_HOSTS instelt, wordt elke host die niet op die lijst staat eveneens geblokkeerd. Wijs de webhook naar de servicenaam van de andere container en voeg die naam toe aan OUTGOING_ALLOWED_HOSTS als u een toegangslijst gebruikt, in plaats van het filter te verwijderen.

Zodra het systeem draait, is de operationele belasting gering. Houd de release notes in de gaten en maak een dump van de database voor elke upgrade. Een herstart brengt de stack automatisch terug vanwege restart: unless-stopped, mits de Docker-service zelf is ingeschakeld bij het opstarten, en Compose-stacks die terugkeren na een herstart behandelt de gevallen waarin dit niet gebeurt.

FAQ

Waarom blijft Planka oneindig laden na het inloggen?

De inloggegevens werden geaccepteerd, maar de live-verbinding niet. De browser opent een socket naar de oorsprong van de pagina, terwijl Planka zijn toegestane socket-oorsprongen afleidt van BASE_URL. Als u die variabele op http://localhost:3000 laat staan terwijl u de site via https://kanban.example.com benadert, weigert de server de verbinding. De ontwikkelaarsconsole toont falende verzoeken naar /socket.io/. Stel BASE_URL in op het exacte publieke adres zonder afsluitende slash, voeg TRUST_PROXY=true toe zodat de app de X-Forwarded-Proto-header van uw reverse proxy respecteert, en voer daarna docker compose up -d uit.

Hoe maak ik de eerste Planka-beheerder aan?

Sinds versie 1.13 wordt er niet langer automatisch een beheerder aangemaakt. Stel ofwel DEFAULT_ADMIN_EMAIL in met de bijbehorende variabelen voor wachtwoord, naam en gebruikersnaam en start de stack, of voer docker compose run --rm planka npm run db:create-admin-user uit en beantwoord de vragen. Het interactieve commando is veiliger op een gedeelde server, omdat het wachtwoord nooit in de geconfigureerde omgeving van de container terechtkomt waar docker inspect het kan inzien. Het ingeschakeld laten van DEFAULT_ADMIN_EMAIL na de installatie voorkomt wijzigingen aan de naam, rol en het e-mailadres van dat account, en blokkeert verwijdering via de interface. Verwijder DEFAULT_ADMIN_PASSWORD na de installatie, omdat het ingeschakeld laten ervan het wachtwoord van het bijbehorende account bij elke opstart reset.

Waar slaat Planka bijlagen en avatars op?

Alle geüploade bestanden bevinden zich in Planka 2 onder /app/data in de container, inclusief bijlagen, gebruikersavatars en achtergronden voor borden. Koppel dat pad aan een named volume. Zonder expliciete mount gebruikt de Docker-image een anoniem volume, dat een daaropvolgende docker compose up niet automatisch opnieuw koppelt na docker compose down. Een bind mount werkt ook, maar het Node-proces draait als UID 1000, dus voer sudo chown -R 1000:1000 uit op de host-directory, anders falen uploads met een rechtenfout.

Hoeveel RAM heeft een zelfgehoste Planka nodig?

De technische FAQ van het project adviseert minimaal 2 GB RAM en 10 GB opslag voor kleine teams. De standaard Docker-implementatie draait een Node-proces, een Postgres-server met een backend-proces per open verbinding, en een interne Squid-proxy voor het filteren van uitgaand verkeer. Voer docker stats --no-stream uit na een normale week en baseer de grootte op uw eigen cijfers. Houd de schijfruimte nauwkeuriger in de gaten dan het geheugen, omdat bijlagen de grootste groeifactor zijn.

Hoe upgrade ik Planka zonder gegevensverlies?

Maak direct voor de upgrade een dump van de database en archiveer het volume met uploads, vertrouw niet op de planning van de vorige nacht. Gebruik docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql en behoud de -T om pseudo-terminaltoewijzing voor de omgeleide uitvoer uit te schakelen. Lees de release notes voor elke versie die u overslaat, wijzig de image-tag naar een specifieke release in plaats van latest, voer daarna docker compose pull en docker compose up -d uit en monitor de log voor de migratie. Houd de Postgres-tag vastgepind op de major-versie, omdat de server weigert een datadirectory te openen die door een andere major-versie is geschreven.

Was dit artikel nuttig?