Life with 🐘 🐳 🐧 💻

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 en explorant le code source, j’ai découvert un projet 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 ici

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:grtwushjdkbiyuPasb1d@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

Voici donc la première étape pour installer Kanboard avec Dokploy. À partir de là, vous pouvez explorer des sujets plus avancés : gestion des utilisateurs, configuration SMTP pour les notifications ou encore OAuth pour une authentification simplifiée. Vous pouvez aussi enrichir votre installation avec des plugins pour le suivi du temps, les diagrammes de Gantt ou l’automatisation des tâches.

Souhaitez-vous que je vous montre ensuite comment utiliser Kanboard au quotidien, organiser vos projets, automatiser certaines actions et collaborer efficacement en équipe ? Si oui, dites-le-moi en commentaire ou contactez-moi, je serai ravi de présenter des exemples concrets et quelques plugins incontournables !

Dennis de Best