Self-host Planka con Docker Compose su VPS
Deploy di Planka su VPS con Docker Compose, Postgres e Traefik: configura il bootstrap admin e correggi BASE_URL per evitare errori di login.
Cosa offre il self-hosting di Planka
Il self-hosting di Planka offre al team una bacheca Kanban con il modello di schede, liste ed etichette già noto agli utenti di Trello, eseguita su un VPS sotto il vostro controllo. Non ci sono limiti al numero di utenti né costi per singolo utente, perché l'unico costo è quello del server. Questa guida esegue il deploy con Docker Compose dietro Traefik, usa Postgres per i dati e un volume denominato per ogni file caricato dagli utenti.
Planka 2 viene distribuito con la Fair Use License del progetto, che il progetto descrive come disponibile con il codice sorgente, non come open source. È consentito eseguirlo per i progetti interni della propria organizzazione. L'offerta a terzi come servizio commerciale in hosting richiede una licenza Pro o Enterprise.
Il lettore di riferimento è un team di due-cinque persone che sta abbandonando il piano gratuito di Trello. Se state ancora decidendo quale bacheca usare, leggete prima il confronto tra le alternative self-hosted a Trello. Questa guida presuppone che la scelta sia già stata fatta e tratta soltanto il deploy.
Servono un VPS con Docker Engine e il plugin Compose, oltre a un record DNS A che punti al VPS. Serve anche un'istanza Traefik che gestisca già la terminazione TLS (transport layer security) su quel server. Se Traefik non è ancora disponibile, configurate prima un reverse proxy Traefik davanti a più applicazioni Compose e consultate le nozioni di base su Docker Compose per un VPS se il file seguente non vi è familiare.
Di quanta RAM ha bisogno una VPS per Planka?
Le FAQ tecniche del progetto consigliano almeno 2 GB di RAM e 10 GB di spazio di archiviazione per piccoli team; considera questi valori come un punto di partenza e non come una misura definitiva.
Il carico effettivo è contenuto: un processo Node.js che serve l'API e il frontend compilato, e un server Postgres che gestisce i dati, il quale esegue un processo di supervisione più un processo backend per ogni connessione aperta. All'interno del container Planka viene eseguito anche un piccolo processo proxy per filtrare le richieste in uscita. Un piano da 2 GB soddisfa la raccomandazione di RAM del progetto per i piccoli team. Una bacheca è un servizio leggero, quindi se la stessa VPS deve ospitare anche i documenti del tuo team, dimensiona prima per quell'applicazione: eseguire AFFiNE come workspace in stile Notion richiede un paio di gigabyte dedicati prima ancora che Planka inizi a consumare risorse.
Dimensiona il disco prima della memoria, poiché sono gli allegati a occupare spazio nel tempo. Misura la tua istanza invece di affidarti a questo paragrafo:
docker stats --no-stream
docker system df -vIl primo comando mostra l'utilizzo di memoria e CPU in tempo reale per ogni container. Il secondo mostra quanto spazio occupa ogni volume. Effettua entrambe le rilevazioni dopo una normale settimana lavorativa, non il giorno dell'installazione, poiché una bacheca inattiva non fornisce informazioni utili sull'utilizzo reale del tuo team.
Scrittura del file Compose
Crea la directory e assumine la proprietà, in modo da non dover mai modificare questi file tramite sudo.
sudo mkdir -p /opt/planka
sudo chown "$USER":"$USER" /opt/planka
cd /opt/plankaGenera i secret in un file .env accanto al file Compose. Compose legge automaticamente quel file ed esegue la sostituzione dei valori.
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 è intenzionale. Una stringa esadecimale contiene solo cifre e lettere dalla a alla f, quindi non può compromettere la stringa di connessione DATABASE_URL in cui viene inserita. Il formato Base64 standard può contenere una barra, un segno più e un segno uguale di padding, ma mai una chiocciola; i caratteri con un significato speciale in un URL di connessione richiedono la codifica percentuale. Il pattern più ampio è trattato in mantenere i secret fuori dal file Compose.
Ora docker-compose.yml. Sostituisci kanban.example.com con il tuo hostname in entrambi i punti in cui appare.
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:Quattro decisioni in quel file meritano una spiegazione, poiché sono quelle che le persone cambiano per poi pentirsene.
- Non c'è alcun blocco
ports:sul servizio Planka. Traefik raggiunge il container attraverso la reteproxy, quindi la porta 1337 non viene mai pubblicata sull'host. Pubblicarla darebbe a chiunque un modo per aggirare il proxy e il certificato. loadbalancer.server.port=1337indica la porta all'interno del container. Planka è in ascolto sulla 1337 e l'esempio upstream la raggiunge solo sulla 3000 perché mappa la porta sull'host. Qui non c'è alcuna mappatura dell'host, quindi bisogna comunicare a Traefik la porta del container.condition: service_healthysi abbina all'healthcheck di Postgres. Senza di esso, Planka si avvia prima che il database accetti connessioni, fallisce la prima query ed esce, il che appare come un crash loop. I meccanismi sono spiegati in healthcheck di Compose e ordine di avvio.- Il servizio di database è chiamato
postgresdi proposito. Planka 2 instrada le proprie richieste in uscita attraverso un filtro interno la cui block list predefinita èlocalhost,postgres. Rinominare il servizio significa rimuovere silenziosamente il database da quell'elenco.
Verifica che Compose riesca a vedere i secret prima di avviare qualsiasi cosa:
docker compose config | grep -E 'image:|BASE_URL|POSTGRES_USER'Questo comando stampa il file con i valori .env già sostituiti. Un valore vuoto indica che Compose non sta leggendo il file .env, solitamente perché stai eseguendo il comando da una directory diversa.
Cosa fanno realmente le variabili di bootstrap dell'amministratore
Dalla versione 1.13 di Planka non viene creato alcun amministratore automaticamente, quindi un database nuovo non ha utenti in grado di accedere. Il gruppo DEFAULT_ADMIN_* è uno dei due modi per risolvere il problema.
All'avvio, Planka cerca un utente corrispondente a DEFAULT_ADMIN_EMAIL. Se non ne trova nessuno, ne crea uno utilizzando la password, il nome visualizzato e il nome utente impostati insieme ad esso. Ai successivi avvii, aggiorna anche l'account corrispondente basandosi su queste variabili, inclusa la reimpostazione della password quando DEFAULT_ADMIN_PASSWORD rimane impostato.
DEFAULT_ADMIN_EMAIL svolge una seconda funzione che spesso trae in inganno. Finché la variabile rimane impostata, non è possibile modificare il nome, il ruolo o l'indirizzo email dell'account indicato, né eliminarlo tramite l'interfaccia. Si tratta di una protezione contro il blocco accidentale, ed è anche il motivo per cui non è possibile rinominare tale account o cambiarne l'email nella UI. Rimuovi la variabile e riavvia; l'account diventerà un amministratore ordinario che potrai modificare come qualsiasi altro.
La riga della password è quella su cui prestare attenzione. Qualsiasi cosa sotto environment: è leggibile da chiunque possa eseguire docker inspect sul container, quindi DEFAULT_ADMIN_PASSWORD non dovrebbe risiedervi in modo permanente. Accedi, elimina quella riga, esegui nuovamente docker compose up -d, quindi cambia la password nell'interfaccia.
Il metodo più pulito evita del tutto le variabili. Commenta l'intero gruppo DEFAULT_ADMIN_*, quindi crea l'account in modo interattivo:
docker compose run --rm planka npm run db:create-admin-userIl comando richiede email, password, nome visualizzato e un nome utente opzionale, scrivendo l'utente direttamente nel database. La password non tocca mai il file Compose o l'ambiente configurato del container. Usa questo metodo se più di una persona ha accesso alla shell del VPS. Il comando avvia prima Postgres a causa di depends_on, quindi funziona anche su uno stack che non è mai stato avviato.
Entrambi i metodi richiedono la gestione manuale delle password di Planka. Fino alla versione 2.1.1, l'edizione Community poteva delegare gli accessi a un provider OIDC come Authentik in esecuzione come server di single sign-on personale, ma la versione 2.2.0, rilasciata nell'agosto 2026, ha spostato OIDC e SSO in PLANKA Pro. Ciò che l'edizione Community ha guadagnato nello stesso rilascio è l'autenticazione a due fattori (TOTP) per gli account locali, quindi attivala almeno per l'account amministratore.
Perché BASE_URL interrompe i login quando non corrisponde all'hostname
BASE_URL è l'indirizzo esatto digitato dagli utenti nel browser, comprensivo di schema e privo di barra finale. Per questo stack si tratta di https://kanban.example.com. Planka genera i propri link e l'elenco delle origini WebSocket consentite partendo da questo valore; di conseguenza, un BASE_URL errato non restituisce un errore chiaro. La pagina viene caricata, ma il caricamento non termina mai.
Lo scenario tipico: si copia l'esempio upstream, si lascia BASE_URL=http://localhost:3000 invariato e si accede al sito tramite HTTPS sul proprio dominio reale. Il modulo di login invia i dati e le credenziali vengono accettate. La bacheca tuttavia non appare. Aprendo la console per sviluppatori del browser, si noterà che le richieste a /socket.io/ falliscono, poiché il socket si connette all'origine della pagina del browser, ma la restrizione di origine del server consente solo quella derivata da BASE_URL.
TRUST_PROXY=true rappresenta l'altra metà dello stesso problema. Planka è in esecuzione dietro Traefik, quindi ogni richiesta arriva dall'indirizzo del proxy tramite HTTP semplice all'interno della rete Docker. Senza TRUST_PROXY, l'applicazione ignora gli header X-Forwarded-Proto e X-Forwarded-For impostati da Traefik, ritenendo la connessione non sicura e trattando ogni client come un unico indirizzo IP condiviso. Con questa opzione attiva, l'applicazione legge gli header e concorda con il browser riguardo allo schema utilizzato.
Traefik instrada i WebSocket senza configurazioni aggiuntive, motivo per cui è preferibile in questo contesto. Con nginx, il proxy deve inoltrare gli header di upgrade, proxy_set_header Upgrade $http_upgrade e proxy_set_header Connection "upgrade", altrimenti si verificherà lo stesso blocco del caricamento per una causa differente. Tali direttive possono essere inserite nel blocco location / generale; un blocco separato per /socket.io è funzionale ma non strettamente necessario.
Spostare la bacheca su un nuovo hostname in un secondo momento richiede di modificare due elementi congiuntamente: il valore BASE_URL e la regola Host() di Traefik. Modificarne solo uno comporta il ripresentarsi del blocco. Servire Planka da un sottopercorso come https://example.com/planka è possibile a partire dalla versione 2.1.0, rilasciata a marzo 2026. Per i tag precedenti, è necessario assegnare un sottodominio dedicato.
Dove Planka archivia allegati e avatar
Planka 2 memorizza tutto ciò che un utente carica in un unico percorso all'interno del container: /app/data. Allegati, avatar degli utenti e immagini di sfondo delle bacheche risiedono tutti in questa directory. La versione 1 utilizzava tre directory separate; pertanto, un file Compose copiato da una guida precedente monta percorsi che non esistono più, lasciando il mount dei dati previsto non configurato.
Quel singolo mount fa la differenza tra una bacheca che sopravvive a un aggiornamento e un pomeriggio perso a risolvere problemi. L'immagine Docker dichiara /app/data come volume, quindi omettere il mount nel file Compose sposta i caricamenti in un volume anonimo. Compose lo preserva durante una normale ricreazione tramite up, ma una successiva operazione di down seguita da up non lo ricollega automaticamente. La bacheca torna visibile, le schede sono presenti, ma ogni link agli allegati risulta non funzionante, poiché le righe del database puntano ancora ai file nel vecchio volume.
Il volume nominato nel file Compose sopra riportato previene questo problema. Anche un bind mount funziona e rende i file più semplici da sottoporre a backup con strumenti standard, ma richiede un passaggio aggiuntivo. Il processo Node all'interno del container viene eseguito con UID 1000, quindi una directory host di proprietà di root genera un errore di permessi al primo caricamento:
sudo chown -R 1000:1000 /opt/planka/dataIl compromesso tra le due soluzioni è analizzato in bind mount rispetto a volumi nominati.
Se gli allegati superano lo spazio disco previsto dal tuo piano, Planka può scriverli su uno storage compatibile con S3, tramite S3_ENDPOINT, S3_BUCKET e le relative variabili di chiave. Questo può puntare a un bucket in hosting o a un object store MinIO self-hosted su un'altra macchina. Decidi questa configurazione prima che il team inizi a popolare la bacheca, poiché l'abilitazione di S3 sposta le operazioni di lettura e scrittura dei file su quel backend senza migrare i caricamenti esistenti.
Avviare lo stack e verificare che funzioni
docker compose pull
docker compose up -d
docker compose psdocker compose ps dovrebbe mostrare postgres come healthy e planka come running. Se Planka si riavvia in un ciclo continuo, la connessione al database è il primo elemento da controllare, non l'applicazione.
docker compose logs -f plankaUn primo avvio riuscito esegue le migrazioni del database, ma la configurazione di produzione imposta noShip: true e sopprime il messaggio di avvio che indica la porta 1337. Verificate direttamente in Postgres che lo schema sia stato realmente creato, invece di fidarvi del log:
docker compose exec postgres psql -U planka -d planka -c '\dt'Un elenco di tabelle che include board e card indica che le migrazioni sono state eseguite. "Did not find any relations" significa che Planka non si è mai connesso. Confrontate quindi DATABASE_URL con i valori POSTGRES_USER e POSTGRES_PASSWORD nel vostro .env.
Controllate quindi il percorso dalla vostra macchina, non dal VPS:
curl -I https://kanban.example.comHTTP/2 200 significa che Traefik dispone di un certificato e raggiunge il container. Un errore 404 restituito da Traefik significa che nessun router ha trovato una corrispondenza: la regola Host() non corrisponde al nome host richiesto oppure Traefik non ha rilevato le label. Un errore 502 significa che il router ha trovato una corrispondenza, ma Traefik non riesce a raggiungere il container, ad esempio perché non è collegato alla rete proxy. Ora aprite il sito e accedete con l'account amministratore.
Eseguire un pg_dump prima di ogni aggiornamento di versione
Due archivi distinti contengono la tua board, pertanto il backup deve coprire entrambi: il database Postgres e il volume planka-data. Esegui il dump del database mentre lo stack è in esecuzione.
docker compose exec -T postgres pg_dump -U planka -d planka > "planka-db-$(date +%F).sql"Il comando -T disabilita l'allocazione del pseudo-terminale predefinita di Compose, mantenendo il dump su un flusso di output semplice.
Successivamente, procedi con gli upload. Individua prima il nome reale del volume, poiché Compose vi antepone il nome della directory del progetto.
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 .Il progetto include anche docker-backup.sh e docker-restore.sh nel repository, e la documentazione ufficiale suggerisce di configurarli tramite un job cron notturno. Entrambi gli approcci sono validi. Ciò che non è accettabile è un backup che non è mai stato ripristinato; pertanto, ripristinalo una volta su una VPS di test e verifica di poter effettuare il login e aprire un allegato. La stessa coppia di archivi si ritrova in ogni applicazione Compose che accetta upload, quindi se in futuro installerai Chatwoot sullo stesso server del tuo help desk, la procedura definita qui sarà riutilizzabile semplicemente modificando i nomi dei volumi.
Esegui il dump immediatamente prima di ogni cambio di versione. Un backup della notte precedente non equivale a un backup eseguito prima della migrazione che stai per avviare.
Fissare i tag e leggere le note di rilascio
Entrambi i tag delle immagini in quel file sono fissati intenzionalmente.
ghcr.io/plankanban/planka:2.2.1 è una release specifica, aggiornata a ottobre 2026. Community 2.3.0 è stata rilasciata il 4 novembre 2026 con correzioni di sicurezza e il progetto upstream raccomanda di aggiornare. Community 2.3.1 è seguita il 5 novembre 2026 e corregge un crash che si verifica modificando le descrizioni delle card nelle bacheche con un membro privo di nome utente. latest cambia ogni volta che l'upstream pubblica una nuova versione, quindi un normale docker compose pull può introdurre una migrazione dello schema in un momento non pianificato. Leggete le note di rilascio prima di modificare quel numero, perché descrivono le modifiche incompatibili e le correzioni di sicurezza. La versione 2.0.3 è stata pubblicata come release di sicurezza, proprio il tipo di aggiornamento che è preferibile leggere invece di installare accidentalmente. Lo stesso vale per la 2.2.1, rilasciata ad agosto 2026: corregge una vulnerabilità di attraversamento dei percorsi che consentiva a un utente autenticato di leggere file arbitrari sulle istanze che usano lo storage locale, come nella configurazione di questa guida; l'advisory indica come interessate la versione 2.1.1 e quelle precedenti. Se provenite dalla serie 2.1.x, leggete prima le note della 2.2.0, perché quella release disattiva gli utenti che hanno effettuato l'accesso esclusivamente tramite SSO finché un amministratore non assegna loro una password e li riattiva. Qui fissare il tag è semplice perché l'upstream pubblica le immagini. Quando un progetto non ne pubblica, dovete applicare la stessa disciplina con un passaggio aggiuntivo, come nel caso di openGym compilato sul server a partire da un tag git estratto.
postgres:16-alpine è fissato a una versione principale per un motivo più importante. Postgres scrive la directory dei dati in un formato legato alla versione principale e il server rifiuta di aprire una directory scritta da una versione diversa. Impostate postgres:latest, lasciate che il tag superi la versione 16 e il container non si avvierà. L'immagine 17, ad esempio, si arresta con:
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.Non viene perso nulla e un riavvio non risolve il problema. Il passaggio a una nuova versione principale di Postgres richiede un dump dalla versione precedente e un ripristino in una directory dei dati vuota sulla nuova versione, un'esecuzione di pg_upgrade, che converte i dati senza dump ma richiede la disponibilità contemporanea dei binari del server vecchio e nuovo, oppure la replica logica verso un server che esegue la nuova versione, seguita da uno switchover. Ogni percorso è una migrazione pianificata, non un effetto collaterale del download di un'immagine; la replica logica consente al server precedente di continuare a funzionare mentre quello nuovo recupera le modifiche.
Se state spostando un'installazione Planka 1.x esistente invece di partire da zero, l'aggiornamento ha una procedura documentata specifica nella documentazione del progetto e non è possibile tornare alla versione 1 senza un backup creato in precedenza.
Modalità di errore e stringhe visualizzate
Planka si riavvia in loop e il log indica il database. Le credenziali in DATABASE_URL non corrispondono all'ambiente Postgres. Nota che POSTGRES_PASSWORD viene applicata solo durante la prima inizializzazione della directory dati, quindi correggere la variabile dopo un primo avvio errato non ha effetto. Modifica la password del ruolo del database con ALTER ROLE affinché corrisponda alla password configurata; rimuovere il volume db-data è un'opzione valida solo per installazioni temporanee senza dati da conservare.
Il login ha successo ma la bacheca non viene caricata. BASE_URL non corrisponde all'indirizzo nella barra del browser, quindi il server rifiuta l'origine del socket. La console del browser mostra richieste fallite verso /socket.io/.
I caricamenti falliscono mentre tutto il resto funziona. Un bind mount è di proprietà di root. Esegui sudo chown -R 1000:1000 sulla directory host e riavvia il container.
Gli allegati sono scomparsi dopo un aggiornamento. /app/data non era collegato al volume originale dei caricamenti. Ricollega quel volume o ripristina i file da un backup, quindi utilizza un volume denominato prima di modificare nuovamente il tag dell'immagine.
Traefik restituisce 404. Nessun router ha corrisposto alla richiesta: la regola Host() non corrisponde al tuo record DNS, oppure le etichette non hanno raggiunto Traefik. docker compose config mostra le etichette dopo la sostituzione, dove diventano visibili eventuali errori di battitura. Un errore 502 indica invece che la rotta ha corrisposto ma il container non è stato raggiunto; verifica che sia sulla rete proxy.
Le notifiche o i webhook non arrivano. Planka 2 invia le sue richieste HTTP in uscita attraverso un filtro interno e la lista di blocco predefinita copre localhost e postgres. Un webhook diretto a localhost è bloccato per progettazione e, una volta impostato OUTGOING_ALLOWED_HOSTS, ogni host non presente in tale lista viene bloccato a sua volta. Punta il webhook al nome del servizio dell'altro container e aggiungi quel nome a OUTGOING_ALLOWED_HOSTS se utilizzi una lista di elementi consentiti, invece di rimuovere il filtro.
Una volta avviato, il carico operativo è minimo. Monitora le note di rilascio ed esegui il dump del database prima di ogni aggiornamento. Un riavvio ripristina lo stack automaticamente grazie a restart: unless-stopped, a condizione che il servizio Docker sia abilitato all'avvio, e Stack Compose che si riavviano dopo un reboot copre i casi in cui ciò non avviene.
FAQ
Perché Planka rimane in caricamento infinito dopo il login?
Le credenziali sono state accettate, ma la connessione live no. Il browser apre il socket verso l'origine della pagina, mentre Planka deriva le origini socket consentite da BASE_URL; lasciare questa variabile su http://localhost:3000 mentre si accede al sito tramite https://kanban.example.com causa il rifiuto della connessione da parte del server. La console dello sviluppatore mostra richieste fallite verso /socket.io/. Imposta BASE_URL sull'indirizzo pubblico esatto senza barra finale, aggiungi TRUST_PROXY=true affinché l'applicazione rispetti l'header X-Forwarded-Proto del tuo reverse proxy, quindi esegui docker compose up -d.
Come creo il primo utente amministratore di Planka?
Dalla versione 1.13 non viene creato alcun amministratore automaticamente. Puoi impostare DEFAULT_ADMIN_EMAIL con le relative variabili per password, nome e username e avviare lo stack, oppure eseguire docker compose run --rm planka npm run db:create-admin-user e rispondere alle domande. Il comando interattivo è più sicuro su un server condiviso, poiché la password non viene inserita nell'ambiente configurato del container, dove docker inspect potrebbe leggerla. Mantenere DEFAULT_ADMIN_EMAIL impostato in seguito impedisce modifiche a nome, ruolo e indirizzo email di quell'account, bloccandone anche l'eliminazione dall'interfaccia. Rimuovi DEFAULT_ADMIN_PASSWORD dopo la configurazione, poiché lasciarlo impostato reimposta la password dell'account corrispondente a ogni avvio.
Dove archivia Planka allegati e avatar?
Tutti i file caricati risiedono in /app/data all'interno del container in Planka 2, inclusi allegati, avatar utente e sfondi delle bacheche. Monta quel percorso su un volume denominato. Senza un mount esplicito, l'immagine Docker utilizza un volume anonimo, che un successivo docker compose up non ricollega automaticamente dopo docker compose down. Anche un bind mount funziona, ma il processo Node viene eseguito come UID 1000, quindi esegui sudo chown -R 1000:1000 sulla directory host o i caricamenti falliranno con un errore di permessi.
Quanta RAM richiede un'istanza self-hosted di Planka?
Le FAQ tecniche del progetto raccomandano almeno 2 GB di RAM e 10 GB di spazio di archiviazione per piccoli team. Il deployment Docker predefinito esegue un processo Node, un server Postgres con un processo backend per ogni connessione aperta e un proxy Squid interno per il filtraggio delle richieste in uscita. Esegui docker stats --no-stream dopo una settimana di utilizzo normale e dimensiona in base ai tuoi dati. Monitora il disco più attentamente della memoria, poiché sono gli allegati a crescere nel tempo.
Come aggiorno Planka senza perdere dati?
Esegui il dump del database e archivia il volume dei caricamenti immediatamente prima dell'aggiornamento, non basarti sul backup della notte precedente. Usa docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql, mantenendo -T per disabilitare l'allocazione dello pseudo-terminale per l'output reindirizzato. Leggi le note di rilascio per ogni versione che intendi saltare, modifica il tag dell'immagine su una release specifica invece di latest, quindi esegui docker compose pull e docker compose up -d e monitora il log per verificare la migrazione. Mantieni il tag di Postgres bloccato sulla sua major version, poiché il server rifiuta di aprire una directory dati scritta da una versione major differente.