Comment installer le logiciel de gestion de projet Kanboard sur Debian 10

Kanboard est un logiciel de gestion de projet gratuit, open-source et auto-hébergé qui peut être utilisé pour gérer des projets en utilisant la méthodologie Kanban. Tu peux visualiser le flux de travail, limiter les travaux en cours et travailler efficacement depuis l’interface Web de Kanboard. Kanban te permet de personnaliser tes tableaux en fonction de tes besoins. Tu peux étendre les fonctionnalités de Kanbord avec des plugins et des services tiers.

Dans ce tutoriel, nous allons t’expliquer pas à pas comment installer et configurer Kanboard sur Debian 10.

Configuration requise

  • Un serveur fonctionnant sous Debian 10.
  • Un mot de passe root est configuré sur ton serveur.

Pour commencer

Il est recommandé de mettre à jour ton système avec la dernière version. Tu peux mettre à jour tous les paquets avec la commande suivante :

apt-get update -y
apt-get upgrade -y

Une fois que tous les paquets sont mis à jour, redémarre ton système pour appliquer les changements de configuration.

Installer le serveur LEMP

Kanboard fonctionne sur le serveur web, écrit en PHP et utilise MariaDB pour le backend de la base de données. Tu devras donc installer Nginx, MariaDB, PHP et d’autres modules PHP sur ton système.

apt-get install nginx mariadb-server php7.3 php7.3-common php7.3-cli php7.3-fpm php7.3-mbstring php7.3-json php7.3-opcache php7.3-zip php7.3-xml php7.3-gd php7.3-ldap php7.3-mysql php7.3-json php7.3-sqlite3

Une fois l’installation terminée, démarre le service Nginx et MariaDB, et active-les pour qu’ils démarrent après le redémarrage du système avec la commande suivante :

systemctl start nginx
systemctl start mariadb
systemctl enable nginx
systemctl enable mariadb

Configurer MariaDB pour Kanboard

Par défaut, MariaDB n’est pas sécurisée, il est donc recommandé de la sécuriser. Tu peux la sécuriser en exécutant le script suivant.

mysql_secure_installation

Réponds à toutes les questions comme indiqué ci-dessous :

    Enter current password for root (enter for none):
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

Une fois que MariaDB est sécurisée, connecte-toi au shell MariaDB :

mysql -u root -p

Saisis ton mot de passe root à l’invite, puis crée une base de données et un utilisateur pour Kanboard :

MariaDB [(none)]>CREATE DATABASE kanboard CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Ensuite, accorde tous les privilèges à la base de données Kanboard avec la commande suivante :

MariaDB [(none)]>GRANT ALL PRIVILEGES ON kanboard.* TO 'kanboard'@'localhost' IDENTIFIED BY 'mypassword';

Remplace le mot ‘mypassword‘ par un mot de passe sécurisé de ton choix dans la commande SQL ci-dessus. Ensuite, vide les privilèges avec la commande suivante :

MariaDB [(none)]>FLUSH PRIVILEGES;

Enfin, quitte le shell MariaDB avec la commande suivante :

MariaDB [(none)]>\q

Installer Kanboard

Tout d’abord, télécharge la dernière version de Kanboard depuis le dépôt Git avec la commande suivante :

wget https://github.com/kanboard/kanboard/archive/v1.2.10.tar.gz

Une fois le téléchargement terminé, extrais le fichier téléchargé avec la commande suivante :

tar -xvf v1.2.10.tar.gz

Ensuite, copie le répertoire extrait dans le répertoire racine d’Apache web avec la commande suivante :

cp -r kanboard-1.2.10 /var/www/html/kanboard

Ensuite, copie le fichier de configuration de l’exemple de Kanboard avec la commande suivante :

cd /var/www/html/kanboard
cp config.default.php config.php

Ensuite, ouvre le fichier config.php avec ton éditeur préféré :

nano config.php

Définis les paramètres de ta base de données comme indiqué ci-dessous :

// Database driver: sqlite, mysql or postgres (sqlite by default)
define('DB_DRIVER', 'mysql');

// Mysql/Postgres username
define('DB_USERNAME', 'kanboard');

// Mysql/Postgres password
define('DB_PASSWORD', 'password');

// Mysql/Postgres hostname
define('DB_HOSTNAME', 'localhost');

// Mysql/Postgres database name
define('DB_NAME', 'kanboard');

Sauvegarde et ferme le fichier lorsque tu as terminé. Ensuite, définis les permissions appropriées avec la commande suivante :

chown -R www-data:www-data /var/www/html/kanboard

Une fois que tu as terminé, tu peux passer à l’étape suivante.

Configurer Nginx pour Kanboard

Ensuite, tu devras créer un fichier d’hôte virtuel Nginx pour Kanboard. Tu peux le créer avec la commande suivante :

nano /etc/nginx/conf.d/kanboard.conf

Ajoute les lignes suivantes :

server {
        listen       80;
        server_name  example.com;
        index        index.php;
        root         /var/www/html/kanboard;
        client_max_body_size 32M;

        location / {
            try_files $uri $uri/ /index.php$is_args$args;
        }

        location ~ \.php$ {
            try_files $uri =404;
            fastcgi_split_path_info ^(.+\.php)(/.+)$;
            fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            fastcgi_index index.php;
            include fastcgi_params;
        }

        location ~* ^.+\.(log|sqlite)$ {
            return 404;
        }

        location ~ /\.ht {
            return 404;
        }

        location ~* ^.+\.(ico|jpg|gif|png|css|js|svg|eot|ttf|woff|woff2|otf)$ {
            log_not_found off;
            expires 7d;
            etag on;
        }

        gzip on;
        gzip_comp_level 3;
        gzip_disable "msie6";
        gzip_vary on;
        gzip_types
            text/javascript
            application/javascript
            application/json
            text/xml
            application/xml
            application/rss+xml
            text/css
            text/plain;
    }

Sauvegarde et ferme le fichier lorsque tu as terminé. Ensuite, vérifie que Nginx n’a pas d’erreur de syntaxe avec la commande suivante :

nginx -t

Tu devrais voir la sortie suivante :

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Enfin, redémarre Nginx et le service php-fpm avec la commande suivante :

systemctl restart nginx
systemctl restart php7.3-fpm

Tu peux vérifier l’état du service Nginx avec la commande suivante :

systemctl status nginx

Tu devrais voir la sortie suivante :

? nginx.service - A high performance web server and a reverse proxy server
   Loaded: loaded (/lib/systemd/system/nginx.service; enabled; vendor preset: enabled)
   Active: active (running) since Sat 2019-07-13 06:05:09 EDT; 26s ago
     Docs: man:nginx(8)
  Process: 13412 ExecStartPre=/usr/sbin/nginx -t -q -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
  Process: 13413 ExecStart=/usr/sbin/nginx -g daemon on; master_process on; (code=exited, status=0/SUCCESS)
 Main PID: 13414 (nginx)
    Tasks: 2 (limit: 1138)
   Memory: 2.9M
   CGroup: /system.slice/nginx.service
           ??13414 nginx: master process /usr/sbin/nginx -g daemon on; master_process on;
           ??13415 nginx: worker process

Jul 13 06:05:09 debian systemd[1]: Starting A high performance web server and a reverse proxy server...
Jul 13 06:05:09 debian systemd[1]: nginx.service: Failed to parse PID from file /run/nginx.pid: Invalid argument
Jul 13 06:05:09 debian systemd[1]: Started A high performance web server and a reverse proxy server.

Accéder à l’interface Web de Kanboard

Kanboard est maintenant installé et configuré, il est temps d’accéder à l’interface Web de Kanboard.

Ouvre ton navigateur Web et tape l’URL http://example.com. Tu seras redirigé vers la page suivante :

Connexion à Kanboard

Indique le nom d’utilisateur et le mot de passe par défaut d’admin / admin et clique sur le bouton Se connecter. Tu devrais voir le tableau de bord par défaut de Kanboard sur la page suivante :

Tableau de bord d'administration de Kanboard

Il est recommandé de modifier ton mot de passe admin par défaut. Pour cela, va dans le menu Admin > Gestion des utilisateurs > admin. Tu devrais voir la page suivante :

Gestionnaire des utilisateurs de Kanboard

Maintenant, clique sur le bouton Changer le mot de passe. Tu devrais voir la page suivante :

Changement de mot de passe

Indique ton nouveau mot de passe et clique sur le bouton Enregistrer.

Félicitations ! Tu as réussi à installer et à configurer Kanboard sur Debian 10. Tu peux maintenant gérer tes tâches facilement à partir de l’interface Web de Kanboard. N’hésite pas à me demander si tu as des questions.

Vous aimerez aussi...