SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Auto-héberger Planka avec Docker Compose et Traefik

Déployez Planka sur un VPS avec Docker Compose, Postgres et Traefik. Évitez l’erreur de connexion liée à BASE_URL et configurez le bootstrap admin.

Ce que vous obtenez en auto-hébergeant Planka

L’auto-hébergement de Planka fournit à votre équipe un tableau Kanban avec le modèle de cartes, de listes et d’étiquettes déjà connu de Trello, exécuté sur un VPS que vous contrôlez. Il n’y a aucune limite de sièges ni facturation par utilisateur, car le seul coût est celui du serveur. Ce guide le déploie avec Docker Compose derrière Traefik, en utilisant Postgres pour les données et un volume nommé pour chaque fichier téléversé par les utilisateurs.

Planka 2 est distribué sous la Fair Use License propre au projet, que celui-ci décrit comme une licence avec code source disponible plutôt qu’une licence open source. Vous pouvez l’exécuter pour les projets internes de votre propre organisation. Pour le proposer à des tiers comme service hébergé commercial, vous devez disposer d’une licence Pro ou Enterprise.

Le cas visé ici est celui d’une équipe de deux à cinq personnes qui quitte l’offre gratuite de Trello. Si vous hésitez encore sur le tableau à utiliser, consultez d’abord la comparaison des alternatives auto-hébergées à Trello. Ce guide part du principe que votre choix est déjà fait et couvre uniquement le déploiement.

Vous avez besoin d’un VPS exécutant Docker Engine avec le plugin Compose, ainsi que d’un enregistrement DNS de type A pointant vers ce VPS. Vous avez également besoin d’une instance Traefik qui termine déjà les connexions TLS (Transport Layer Security) sur ce serveur. Si Traefik n’est pas encore installé, configurez d’abord un reverse proxy Traefik devant plusieurs applications Compose, puis consultez les bases de Docker Compose pour un VPS si le fichier ci-dessous ne vous est pas familier.

De quelles ressources VPS Planka a-t-il besoin ?

La FAQ technique du projet recommande au moins 2 GB de RAM et 10 GB de stockage pour les petites équipes. Considérez donc ces valeurs comme un point de départ, et non comme une mesure.

L’exécution réelle est légère : un processus Node.js fournit l’API et le frontend compilé, tandis qu’un serveur Postgres stocke les données. Postgres exécute un processus superviseur et un processus backend pour chaque connexion ouverte. Un petit processus proxy s’exécute également dans le conteneur Planka pour filtrer ses requêtes sortantes. Une formule de 2 GB correspond à la recommandation de RAM du projet pour les petites équipes. Un tableau consomme peu de ressources. Si le même VPS doit aussi héberger les documents de votre équipe, dimensionnez-le d’abord pour cette application : exécuter AFFiNE comme espace de travail de type Notion nécessite à lui seul quelques gigaoctets avant que Planka n’utilise quoi que ce soit.

Dimensionnez le disque avant la mémoire, car les pièces jointes sont ce qui augmente le plus. Mesurez votre propre instance au lieu de vous fier à ce paragraphe :

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

La première commande affiche la mémoire et le CPU utilisés en temps réel par chaque conteneur. La seconde indique l’espace occupé par chaque volume. Effectuez ces deux mesures après une semaine de travail normale, et non le jour de l’installation, car un tableau inactif ne vous apprend rien sur votre équipe.

Écrivez le fichier Compose

Créez le répertoire et attribuez-vous-en la propriété afin de ne jamais avoir à modifier ces fichiers via sudo.

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

Générez les secrets dans un fichier .env placé à côté du fichier Compose. Compose lit automatiquement ce fichier et remplace les valeurs.

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 est utilisé volontairement. Une chaîne hexadécimale contient uniquement des chiffres et les lettres de a à f. Elle ne peut donc pas corrompre la chaîne de connexion DATABASE_URL dans laquelle elle est insérée. Le format Base64 standard peut contenir une barre oblique, un signe plus et un signe égal de remplissage, mais jamais d’arobase. Les caractères ayant une signification spéciale dans une URL de connexion doivent être encodés en pourcentage. Le principe général est expliqué dans ne pas stocker les secrets dans le fichier Compose.

Passez maintenant à docker-compose.yml. Remplacez kanban.example.com par votre propre nom d’hôte aux deux endroits où il apparaît.

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:

Quatre choix de ce fichier méritent une explication. Ce sont ceux que l’on modifie souvent avant de le regretter.

  • Le service Planka ne contient aucun bloc ports:. Traefik atteint le conteneur via le réseau proxy. Le port 1337 n’est donc jamais publié sur l’hôte. Le publier permettrait à n’importe qui de contourner votre proxy et votre certificat.
  • loadbalancer.server.port=1337 désigne le port à l’intérieur du conteneur. Planka écoute sur le port 1337. L’exemple en amont ne l’atteint sur le port 3000 que parce qu’il mappe ce port vers l’hôte. Aucun mapping vers l’hôte n’est utilisé ici. Traefik doit donc connaître le port du conteneur.
  • condition: service_healthy fonctionne avec le healthcheck de Postgres. Sans ce paramètre, Planka démarre avant que la base de données accepte les connexions, échoue lors de sa première requête, puis s’arrête. Cela ressemble à une boucle de redémarrage. Le fonctionnement est décrit dans les healthchecks Compose et l’ordre de démarrage.
  • Le service de base de données est nommé postgres volontairement. Planka 2 fait passer ses propres requêtes sortantes par un filtre interne dont la liste de blocage par défaut est localhost,postgres. Si vous renommez le service, vous retirez discrètement votre base de données de cette liste.

Vérifiez que Compose peut accéder à vos secrets avant de démarrer quoi que ce soit :

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

Cette commande affiche le fichier avec les valeurs .env déjà remplacées. Une valeur vide signifie que Compose ne lit pas le fichier .env. La cause est généralement l’exécution de la commande depuis un autre répertoire.

Ce que font réellement les variables d’initialisation de l’administrateur

Depuis Planka 1.13, aucun administrateur n’est créé automatiquement. Une base de données neuve ne contient donc aucun compte permettant de se connecter. Le groupe DEFAULT_ADMIN_* est l’une des deux méthodes pour résoudre ce problème.

Au démarrage, Planka recherche un utilisateur correspondant à DEFAULT_ADMIN_EMAIL. S’il n’en trouve aucun, il en crée un à partir du mot de passe, du nom affiché et du nom d’utilisateur définis à côté de cette variable. Lors des démarrages suivants, il met également à jour le compte correspondant à partir de ces variables. Cela inclut la réinitialisation de son mot de passe lorsque DEFAULT_ADMIN_PASSWORD reste défini.

DEFAULT_ADMIN_EMAIL a un deuxième effet qui surprend souvent. Tant que cette variable reste définie, le compte qu’elle désigne ne peut pas changer de nom, de rôle ou d’adresse e-mail, et ne peut pas être supprimé depuis l’interface. Il s’agit d’une protection contre le verrouillage du compte. C’est également la raison pour laquelle vous ne pouvez pas renommer ce compte ni modifier son adresse e-mail dans l’interface. Supprimez la variable et redémarrez. Le compte redevient alors un administrateur ordinaire que vous pouvez modifier comme les autres.

La ligne du mot de passe demande une attention particulière. Tout ce qui se trouve dans environment: est lisible par toute personne pouvant exécuter docker inspect sur le conteneur. DEFAULT_ADMIN_PASSWORD ne doit donc pas y rester en permanence. Connectez-vous, supprimez cette ligne, exécutez de nouveau docker compose up -d, puis changez votre mot de passe dans l’interface.

La méthode la plus propre consiste à ne pas utiliser ces variables. Commentez tout le groupe DEFAULT_ADMIN_*, puis créez le compte de manière interactive :

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

La commande vous demande l’adresse e-mail, le mot de passe, le nom affiché et un nom d’utilisateur facultatif. Elle écrit ensuite directement l’utilisateur dans la base de données. Le mot de passe ne passe jamais par le fichier Compose ni par l’environnement configuré du conteneur. Utilisez cette méthode si plusieurs personnes disposent d’un accès shell au VPS. La commande démarre d’abord Postgres à cause de depends_on. Elle fonctionne donc sur une stack qui n’a jamais été démarrée.

Dans les deux cas, vous devez gérer manuellement les mots de passe Planka. Jusqu’à la version 2.1.1, l’édition Community pouvait déléguer les connexions à un fournisseur OIDC tel que Authentik exécuté comme votre propre serveur de single sign-on. Mais la version 2.2.0, publiée en août 2026, a déplacé OIDC et SSO dans PLANKA Pro. Dans la même version, l’édition Community a ajouté l’authentification à deux facteurs (TOTP) pour les comptes locaux. Activez-la au minimum pour le compte administrateur.

Pourquoi BASE_URL casse les connexions lorsque sa valeur ne correspond pas au nom d’hôte

BASE_URL est l’adresse exacte que les utilisateurs saisissent dans le navigateur, avec le schéma et sans slash final. Pour cette stack, il s’agit de https://kanban.example.com. Planka construit ses propres liens et sa liste d’origines WebSocket autorisées à partir de cette valeur. Une valeur incorrecte pour BASE_URL ne produit donc pas d’erreur explicite. La page se charge, puis le chargement ne se termine jamais.

Le cas le plus fréquent est le suivant : vous copiez l’exemple fourni par le projet, laissez BASE_URL=http://localhost:3000 en place et accédez au site en HTTPS avec votre vrai domaine. Le formulaire de connexion est envoyé et vos identifiants sont acceptés. Le tableau n’apparaît jamais. Ouvrez la console de développement du navigateur. Vous verrez des requêtes vers /socket.io/ échouer, car le socket se connecte à l’origine de la page du navigateur, tandis que la restriction d’origine du serveur autorise l’origine dérivée de BASE_URL.

TRUST_PROXY=true constitue l’autre moitié du même problème. Planka se trouve derrière Traefik. Chaque requête lui parvient donc depuis l’adresse du proxy, en HTTP non chiffré, sur le réseau Docker. Sans TRUST_PROXY, l’application ignore les en-têtes X-Forwarded-Proto et X-Forwarded-For définis par Traefik. Elle considère alors la connexion comme non sécurisée et traite tous les clients comme s’ils utilisaient une seule et même adresse IP. Lorsque cette option est définie, l’application lit ces en-têtes et utilise le même schéma que le navigateur.

Traefik prend en charge les WebSockets sans configuration supplémentaire. C’est l’une des raisons de le privilégier ici. Avec nginx, le proxy doit transmettre les en-têtes de mise à niveau, proxy_set_header Upgrade $http_upgrade et proxy_set_header Connection "upgrade". Sinon, vous obtenez le même indicateur de chargement bloqué, mais pour une autre raison. Ils peuvent être placés dans le bloc général location /. Un bloc séparé pour /socket.io fonctionne également, mais n’est pas obligatoire.

Déplacer le tableau vers un nouveau nom d’hôte signifie modifier deux éléments simultanément : la valeur de BASE_URL et la règle Traefik Host(). Si vous en modifiez un seul, l’indicateur de chargement réapparaît. Servir Planka depuis un sous-chemin tel que https://example.com/planka est pris en charge à partir de la version 2.1.0, publiée en mars 2026. Avec les tags plus anciens, attribuez-lui son propre sous-domaine.

Emplacement des pièces jointes et des avatars dans Planka

Planka 2 stocke tout ce qu’un utilisateur téléverse sous un seul chemin dans le conteneur : /app/data. Les pièces jointes, les avatars des utilisateurs et les images d’arrière-plan des tableaux y sont tous stockés. La version 1 utilisait trois répertoires distincts. Un fichier Compose copié depuis un ancien article monte donc des chemins qui n’existent plus et le montage de données prévu est absent.

Ce montage unique fait la différence entre un tableau qui survit à une mise à niveau et une mauvaise surprise. L’image Docker déclare /app/data comme volume. Si vous omettez le montage dans Compose, les fichiers téléversés sont placés dans un volume anonyme. Compose le conserve lors d’une recréation ordinaire avec up. En revanche, un down suivi de up ne le rattache pas automatiquement. Le tableau réapparaît normalement, les cartes sont toujours présentes, mais tous les liens vers les pièces jointes sont invalides, car les lignes de la base de données pointent encore vers les fichiers de l’ancien volume.

Le volume nommé du fichier Compose ci-dessus évite ce problème. Un bind mount fonctionne également et facilite la sauvegarde des fichiers avec des outils classiques, mais il nécessite une étape supplémentaire. Le processus Node dans le conteneur s’exécute avec l’UID 1000. Un répertoire hôte appartenant à root provoque donc une erreur de permission lors du premier téléversement :

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

Le compromis entre les deux approches est expliqué dans bind mounts et volumes nommés.

Si les pièces jointes dépassent l’espace disque de votre offre, Planka peut les écrire dans un stockage compatible S3 à la place, via S3_ENDPOINT, S3_BUCKET et les variables de clé correspondantes. Vous pouvez utiliser un bucket hébergé ou un object store MinIO auto-hébergé sur une autre machine. Décidez de cette configuration avant que l’équipe ne remplisse le tableau, car l’activation de S3 redirige les lectures et les écritures de fichiers vers ce backend sans migrer les fichiers déjà téléversés.

Démarrer la stack et vérifier son fonctionnement

docker compose pull
docker compose up -d
docker compose ps

docker compose ps doit afficher postgres comme healthy et planka comme running. Si Planka redémarre en boucle, la connexion à la base de données est le premier point à vérifier, avant l'application elle-même.

docker compose logs -f planka

Un premier démarrage réussi exécute les migrations de base de données, mais la configuration de production définit noShip: true et masque le message de démarrage indiquant le port 1337. Confirmez que le schéma est bien en place en interrogeant directement Postgres plutôt que de vous fier aux logs :

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

Une liste de tables incluant board et card signifie que les migrations ont été effectuées. "Did not find any relations" signifie que Planka ne s'est jamais connecté ; comparez alors DATABASE_URL avec les valeurs POSTGRES_USER et POSTGRES_PASSWORD dans votre .env.

Vérifiez ensuite la route depuis votre propre machine, et non depuis le VPS :

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

HTTP/2 200 signifie que Traefik possède un certificat et atteint le conteneur. Une erreur 404 renvoyée par Traefik signifie qu'aucun routeur ne correspond à la requête : la règle Host() ne correspond pas au nom d'hôte demandé, ou Traefik n'a pas détecté les labels. Une erreur 502 signifie que le routeur a bien identifié la requête mais que Traefik n'a pas pu joindre le conteneur, par exemple parce qu'il n'est pas attaché au réseau proxy. Ouvrez maintenant le site et connectez-vous avec le compte administrateur.

Effectuez un pg_dump avant chaque changement de version

Deux stockages distincts contiennent votre tableau. La sauvegarde doit donc couvrir les deux : la base de données Postgres et le volume planka-data. Effectuez le dump de la base pendant que la stack fonctionne.

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

-T désactive l’allocation par défaut d’un pseudo-terminal par Compose. Le dump reste ainsi sur un flux de sortie standard.

Sauvegardez ensuite les fichiers téléversés. Commencez par trouver le nom réel du volume, car Compose le préfixe avec le nom du répertoire du projet.

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 .

Le projet fournit également docker-backup.sh et docker-restore.sh dans son dépôt. La documentation officielle recommande de les exécuter avec une tâche cron quotidienne. Les deux approches conviennent. En revanche, une sauvegarde que vous n’avez jamais restaurée ne convient pas. Restaurez-en une sur un VPS de test, puis vérifiez que vous pouvez vous connecter et ouvrir une pièce jointe. Cette même paire de stockages existe dans toutes les applications Compose qui acceptent des téléversements. Si vous installez ensuite Chatwoot sur le même serveur que votre bureau d’assistance, la procédure mise en place ici restera applicable, avec principalement les noms de volumes à modifier.

Effectuez le dump immédiatement avant chaque changement de version. Une sauvegarde de la nuit précédente ne remplace pas une sauvegarde effectuée avant la migration que vous allez lancer.

Fixer les tags et lire les notes de version

Les deux tags d'image dans ce fichier sont fixés volontairement.

ghcr.io/plankanban/planka:2.2.1 est une version spécifique, à jour en octobre 2026. La version Community 2.3.0 est sortie le 4 novembre 2026 avec des correctifs de sécurité, et l'upstream recommande la mise à jour. La version Community 2.3.1 a suivi le 5 novembre 2026, corrigeant un crash lors de l'édition de descriptions de cartes sur des tableaux comportant un membre sans nom d'utilisateur. latest change dès que l'upstream publie une mise à jour, donc un docker compose pull de routine peut déclencher une migration de schéma à un moment non choisi. Lisez les notes de version avant de modifier ce numéro, car c'est là que sont décrites les modifications majeures et les correctifs de sécurité. La version 2.0.3 a été publiée en tant que version de sécurité, ce qui est exactement le genre d'information que vous voulez lire plutôt que de subir par accident. Il en va de même pour la version 2.2.1, sortie en août 2026 : elle corrige une faille de type path traversal permettant à un utilisateur connecté de lire des fichiers arbitraires sur les instances utilisant le stockage local, ce qui est la configuration utilisée dans ce guide ; l'avis de sécurité liste les versions 2.1.1 et antérieures comme étant affectées. Si vous venez d'une version 2.1.x, lisez d'abord les notes de la 2.2.0, car cette version désactive les utilisateurs qui ne se sont connectés que via SSO jusqu'à ce qu'un administrateur leur attribue un mot de passe et les réactive. Fixer les versions est simple ici car l'upstream publie des images ; lorsqu'un projet n'en propose aucune, vous devez appliquer la même discipline avec une étape supplémentaire, comme avec openGym compilé sur la machine à partir d'un tag git.

postgres:16-alpine est fixé à une version majeure pour une raison plus contraignante. Postgres écrit son répertoire de données dans un format lié à la version majeure, et le serveur refuse d'ouvrir un répertoire écrit par une version différente. Modifiez postgres:latest, laissez le tag dépasser 16, et le conteneur ne démarrera pas. L'image 17, par exemple, s'arrête avec :

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.

Rien n'est perdu, et rien n'est réparé par un simple redémarrage. Passer à une nouvelle version majeure de Postgres implique un dump de l'ancienne version et une restauration dans un répertoire de données vierge sur la nouvelle, une exécution de pg_upgrade, qui convertit les données sans dump mais nécessite que les binaires de l'ancien et du nouveau serveur soient disponibles simultanément, ou une réplication logique vers un serveur exécutant la nouvelle version suivie d'un basculement. Chaque méthode est une migration planifiée, et non un effet secondaire d'un pull d'image ; la réplication logique permet à l'ancien serveur de continuer à fonctionner pendant que le nouveau se synchronise.

Si vous migrez une installation Planka 1.x existante plutôt que de repartir de zéro, cette mise à niveau possède sa propre procédure documentée dans la documentation du projet, et il n'y a aucun retour possible vers la version 1 sans une sauvegarde effectuée au préalable.

Modes de défaillance et messages affichés

Planka redémarre en boucle et le journal mentionne la base de données. Les identifiants définis dans DATABASE_URL ne correspondent pas à l’environnement Postgres. Notez que POSTGRES_PASSWORD est appliquée uniquement lors de la première initialisation du répertoire de données. Corriger la variable après un premier démarrage incorrect ne change donc rien. Modifiez le mot de passe du rôle de base de données avec ALTER ROLE afin qu’il corresponde au mot de passe configuré. La suppression du volume db-data n’est envisageable que pour une installation jetable ne contenant aucune donnée à conserver.

La connexion réussit, mais le tableau ne se charge jamais. BASE_URL ne correspond pas à l’adresse affichée dans la barre du navigateur. Le serveur rejette donc l’origine de la socket. La console du navigateur affiche des requêtes en échec vers /socket.io/.

Les téléversements échouent alors que tout le reste fonctionne. Le bind mount appartient à root. Exécutez sudo chown -R 1000:1000 sur le répertoire de l’hôte, puis redémarrez le conteneur.

Les pièces jointes ont disparu après une mise à niveau. /app/data n’était pas attaché au volume d’origine des téléversements. Rattachez ce volume ou restaurez les fichiers depuis une sauvegarde, puis utilisez un volume nommé avant de modifier à nouveau le tag de l’image.

Traefik renvoie 404. Aucun routeur ne correspond à la requête : la règle Host() ne correspond pas à votre enregistrement DNS, ou les labels ne sont jamais parvenus jusqu’à Traefik. docker compose config affiche les labels après substitution. C’est à cet endroit que les fautes de frappe deviennent visibles. Une erreur 502 signifie au contraire que la route a correspondu, mais que le conteneur n’a pas pu être joint. Vérifiez donc qu’il se trouve sur le réseau proxy.

Les notifications ou les webhooks n’arrivent jamais. Planka 2 envoie ses requêtes HTTP sortantes via un filtre interne. La liste de blocage par défaut couvre localhost et postgres. Un webhook dirigé vers localhost est bloqué par conception. Une fois OUTGOING_ALLOWED_HOSTS défini, tout hôte qui ne figure pas dans cette liste est également bloqué. Dirigez le webhook vers le nom de service de l’autre conteneur et ajoutez ce nom à OUTGOING_ALLOWED_HOSTS si vous utilisez une liste d’autorisation, plutôt que de supprimer le filtre.

Une fois le service en fonctionnement, sa charge d’exploitation reste faible. Consultez les notes de version et exportez la base de données avant chaque mise à niveau. Un redémarrage relance automatiquement la stack grâce à restart: unless-stopped, à condition que le service Docker soit lui-même activé au démarrage. La section Stacks Compose qui redémarrent après un redémarrage couvre les cas où ce n’est pas le cas.

FAQ

Pourquoi Planka charge-t-il indéfiniment après la connexion ?

Les identifiants ont été acceptés, mais la connexion temps réel a échoué. Le navigateur ouvre son socket vers l’origine de la page, tandis que Planka déduit les origines de socket autorisées depuis BASE_URL. Si cette variable reste définie sur http://localhost:3000 alors que vous accédez au site via https://kanban.example.com, le serveur rejette la connexion. La console du navigateur affiche des requêtes en échec vers /socket.io/. Définissez BASE_URL avec l’adresse publique exacte, sans slash final, ajoutez TRUST_PROXY=true pour que l’application respecte l’en-tête X-Forwarded-Proto transmis par votre reverse proxy, puis exécutez docker compose up -d.

Comment créer le premier utilisateur administrateur de Planka ?

Depuis la version 1.13, aucun administrateur n’est créé automatiquement. Définissez DEFAULT_ADMIN_EMAIL avec les variables correspondantes pour le mot de passe, le nom et le nom d’utilisateur, puis démarrez la stack, ou exécutez docker compose run --rm planka npm run db:create-admin-user et répondez aux invites. La commande interactive est plus sûre sur un serveur partagé, car le mot de passe n’entre jamais dans l’environnement configuré du conteneur, où docker inspect pourrait le lire. Laisser DEFAULT_ADMIN_EMAIL défini ensuite empêche de modifier le nom, le rôle et l’adresse e-mail de ce compte, et bloque sa suppression depuis l’interface. Supprimez DEFAULT_ADMIN_PASSWORD après la configuration, car le laisser défini réinitialise le mot de passe du compte correspondant au démarrage.

Où Planka stocke-t-il les pièces jointes et les avatars ?

Tous les fichiers importés sont stockés sous /app/data dans le conteneur avec Planka 2, notamment les pièces jointes, les avatars des utilisateurs et les arrière-plans des tableaux. Montez ce chemin sur un volume nommé. Sans montage explicite, l’image Docker utilise un volume anonyme, qu’un docker compose up ultérieur ne reconnecte pas automatiquement après docker compose down. Un bind mount fonctionne également, mais le processus Node s’exécute avec l’UID 1000. Exécutez donc sudo chown -R 1000:1000 sur le répertoire de l’hôte, sinon les imports échouent avec une erreur de permissions.

De quelle quantité de RAM un Planka auto-hébergé a-t-il besoin ?

La FAQ technique du projet recommande au moins 2 GB de RAM et 10 GB de stockage pour les petites équipes. Le déploiement Docker par défaut exécute un processus Node, un serveur Postgres avec un processus backend par connexion ouverte, ainsi qu’un proxy Squid interne pour filtrer les requêtes sortantes. Exécutez docker stats --no-stream après une semaine normale et dimensionnez le serveur à partir de vos propres mesures. Surveillez davantage le disque que la mémoire, car ce sont les pièces jointes qui occupent de plus en plus d’espace.

Comment mettre Planka à niveau sans perdre de données ?

Exportez la base de données et archivez le volume contenant les imports juste avant la mise à niveau, et non selon la sauvegarde planifiée de la veille. Utilisez docker compose exec -T postgres pg_dump -U planka -d planka > planka-db.sql en conservant -T pour désactiver l’allocation d’un pseudo-terminal avec la sortie redirigée. Lisez les notes de version de chaque version intermédiaire, remplacez le tag de l’image par celui d’une version précise plutôt que par latest, puis exécutez docker compose pull et docker compose up -d et surveillez le journal pour suivre la migration. Laissez le tag Postgres fixé sur sa version majeure, car le serveur refuse d’ouvrir un répertoire de données écrit par une autre version majeure.

Cet article vous a-t-il été utile ?