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 :

Le menu « Create Service » de Dokploy ouvert, avec Application, Database, Compose, Template et AI Assistant, et Database en surbrillance

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 :

Le terminal Docker de Dokploy : psql connecté à PostgreSQL 18 et la commande CREATE SCHEMA kanboard

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

Le champ Internal Connection URL de la base de données, avec le mot de passe masqué

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

Les sections Deploy Settings et Provider du service Kanboard, réglées sur l'image Docker ghcr.io/kanboard/kanboard

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.

Le formulaire de changement de mot de passe de Kanboard pour l'utilisateur admin

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.

Catégories: DockerDevOps

Dernière mise à jour le

Commentaires

Il n’y a pas encore de commentaire. Soyez le premier à en écrire un.

Écrire un commentaire