Installer Kanboard avec Dokploy
Je cherchais une solution simple mais complète pour créer et partager des tableaux Kanban.
J’ai l’habitude d’outils comme Jira, GitLab ou OpenProject. Ils sont tous excellents, mais souvent trop chers, pas assez complets ou trop gourmands en ressources.
Après quelques recherches, je suis tombé sur Kanboard. Au premier abord, il paraissait un peu « basique » visuellement, mais le code source s’est révélé bien maintenu, entièrement open source (sans version payante), construit avec Docker, PHP et même quelques librairies Symfony.
Statut#
En regardant le GitHub de Kanboard, le premier commit date de plus de 12 ans ! Et au moment où j’écris ces lignes, la dernière version, 1.2.48, a été publiée il y a seulement deux semaines.
C’est impressionnant de voir un projet aussi ancien rester actif et moderne, utilisant des librairies et images Docker récentes.
En plus de cela, il existe de nombreux plugins. Même les plus anciens sont pour la plupart compatibles avec les dernières versions de Kanboard et ajoutent beaucoup de fonctionnalités utiles.
Prérequis#
Nous allons déployer Kanboard via Dokploy, qui s’occupera de récupérer l’image depuis le registre Docker de Kanboard.
Vous pouvez voir comment j’ai configuré Dokploy dans mon article sur le passage à Dokploy
Base de données#
Si aucune configuration n’est spécifiée, Kanboard utilise par défaut sqlite comme base de données. Cela fonctionne, mais on rencontre souvent des problèmes de verrouillage de fichiers et les sauvegardes sont un peu moins pratiques. Nous allons donc configurer une vraie base de données — MySQL, MariaDB ou PostgreSQL. Comme j’utilise déjà PostgreSQL pour plusieurs projets, je vais réutiliser la même instance pour Kanboard.
J’ai un projet de base de données dans Dokploy, utilisant PostgreSQL version 18 (la plus récente à ce jour). Dans Dokploy, créez un nouveau Projet, que vous pouvez appeler infrastructure, puis ajoutez un nouveau service de base de données :

Nommez-le psql18-db et définissez la version postgres:18. Cela créera une configuration par défaut.
Par défaut, Dokploy le monte sur un volume. Cependant, avec PostgreSQL 18, il faut modifier le chemin interne. Dans Advanced > Volumes, le chemin est /var/lib/postgresql/data. Modifiez-le en /var/lib/postgresql.
Une fois cela fait, revenez dans l’onglet General et cliquez sur Deploy pour lancer la base. Lorsqu’elle est démarrée, ouvrez un terminal dans le conteneur pour créer un nouveau schéma.
Si vous n’avez pas changé le nom d’utilisateur à la création, vous pouvez vous connecter avec :
psql -Upostgres
Puis créez un nouveau schéma :

Une fois terminé, copiez l’URL de connexion interne — elle nous servira plus tard.

Elle devrait ressembler à ceci :
postgresql://postgres:YOUR_PASSWORD@infrastructure-psql18db-6r8dvv:5432/postgres
La base de données est maintenant prête et accessible pour notre projet Kanboard (ou tout autre projet sur le même VPS). Selon votre organisation, il peut être pertinent de créer un utilisateur et un schéma dédiés par projet.
Configuration de Kanboard#
Avec la base de données prête, passons au déploiement de Kanboard. Créez un nouveau projet sur le même VPS que votre base.
Ajoutez une nouvelle application, puis dans Docker Image, indiquez :
ghcr.io/kanboard/kanboard
et pour Registry URL :
ghcr.io

Cliquez ensuite sur Deploy. Vous pouvez attribuer un domaine aléatoire et le tester en cliquant sur le dé à côté, configuré sur le port 80. En ouvrant le lien, vous devriez voir la page de connexion Kanboard. Les identifiants par défaut sont admin:admin.
Cependant, nous ne sommes pas encore connectés à notre base PostgreSQL — Kanboard utilise encore un fichier SQLite temporaire, réinitialisé à chaque déploiement.
Pour corriger cela, allez dans l’onglet Environment de votre application Kanboard dans Dokploy.
Définissez ici quelques variables d’environnement. Rappelez-vous du lien de connexion sauvegardé plus tôt : nous allons le décomposer ainsi :
DB_DRIVER=postgres
DB_USERNAME=postgres
DB_PASSWORD=lemotdepasseprecedent
DB_HOSTNAME=lehostnameauto
DB_NAME=kanboard
Enregistrez, puis cliquez à nouveau sur Deploy. Kanboard sera maintenant connecté à votre base PostgreSQL.
Utiliser Kanboard#
La première chose à faire est de changer le mot de passe administrateur. Cliquez sur votre avatar en haut à droite, puis sur Mon profil, et mettez-le à jour.

Conclusion#
Voilà Kanboard qui tourne sur Dokploy avec son propre schéma PostgreSQL. À partir de là, vous pouvez regarder la gestion des utilisateurs, le SMTP pour les notifications ou OAuth, et les plugins pour le suivi du temps, les diagrammes de Gantt ou l’automatisation.
Si vous voulez un article sur la façon dont j’utilise Kanboard au quotidien, dites-le-moi en commentaire.
Commentaires
Il n’y a pas encore de commentaire. Soyez le premier à en écrire un.
Écrire un commentaire