Focalboard est un outil de gestion de projet open source et auto-hébergé, conçu pour aider les développeurs à suivre et à gérer le travail au sein des équipes. Dans ce guide, nous allons vous montrer comment installer Focalboard sur votre serveur Ubuntu 22.04.

Étape 1: Installer et configurer PostgreSQL

Focalboard repose sur PostgreSQL comme serveur de base de données. Si vous n’avez pas encore installé PostgreSQL sur votre système, vous pouvez le faire en utilisant les commandes suivantes :

sudo apt-get update
sudo apt-get install postgresql postgresql-contrib -y

Une fois PostgreSQL installé, vous devez vous connecter au serveur PostgreSQL et créer une base de données et un utilisateur pour Focalboard. Utilisez les commandes suivantes pour vous connecter à PostgreSQL et créer les entités nécessaires :

sudo su- postgres
psql

Dans l’interface de PostgreSQL, exécutez les commandes suivantes pour créer une base de données et un utilisateur :

CREATE DATABASE focaldb;
CREATE USER focaluser WITH PASSWORD 'password';

Remplacez 'password' par un mot de passe fort de votre choix. Après avoir créé la base de données et l’utilisateur, quittez l’interface PostgreSQL en tapant q.

Étape 2: Installer et configurer Focalboard

Maintenant que PostgreSQL est configuré, nous pouvons procéder à l’installation et à la configuration de Focalboard. Suivez les étapes suivantes :

1. Visitez la page de téléchargement de Focalboard sur GitHub et téléchargez la dernière version de Focalboard. Vous pouvez utiliser la commande suivante pour télécharger la dernière version :

VER=$(curl -s https://api.github.com/repos/mattermost/focalboard/releases/latest|grep tag_name | cut -d '\"' -f 4)
wget https://github.com/mattermost/focalboard/releases/download/${VER}/focalboard-server-linux-amd64.tar.gz

2. Une fois le téléchargement terminé, extrayez le fichier téléchargé en utilisant la commande suivante :

tar -xvzf focalboard-server-linux-amd64.tar.gz

3. Déplacez le répertoire focalboard extrait dans le répertoire /opt en utilisant la commande suivante :

sudo mv focalboard/opt

4. Ensuite, ouvrez le fichier de configuration de Focalboard pour l’édition :

sudo nano /opt/focalboard/config.json

5. Dans le fichier de configuration, localisez les lignes suivantes et mettez à jour les valeurs appropriées :

"dbtype": "postgres",
"dbconfig": "postgres://focaluser:password@localhost/focaldb?sslmode=disable&connect;_timeout=10",

Remplacez focaluser par le nom d’utilisateur PostgreSQL que vous avez créé précédemment, et remplacez password par le mot de passe correspondant. Enregistrez les modifications et quittez l’éditeur de texte.

Étape 3: Créer un fichier de service Systemd pour Focalboard

Pour assurer une gestion sans faille de Focalboard, il est recommandé d’utiliser systemd pour démarrer et contrôler le service Focalboard. Créons un fichier de service systemd pour Focalboard :

1. Ouvrez le fichier de service pour l’édition :

sudo nano /lib/systemd/system/focalboard.service

2. Ajoutez les lignes suivantes au fichier de service :

[Unit]
Description=Focalboard server

[Service]
Type=simple
Restart=always
RestartSec=5s
ExecStart=/opt/focalboard/bin/focalboard-server
WorkingDirectory=/opt/focalboard

[Install]
WantedBy=multi-user.target

Enregistrez les modifications et quittez l’éditeur de texte.

3. Rechargez le démon systemd pour appliquer les modifications :

sudo systemctl daemon-reload

4. Démarrez le service Focalboard et activez-le au démarrage :

sudo systemctl start focalboard
sudo systemctl enable focalboard

5. Vérifiez l’état du service Focalboard :

sudo systemctl status focalboard

Si tout est configuré correctement, vous devriez voir le statut active (running).

Étape 4: Configurer Nginx comme un proxy inverse

Pour fournir un accès sécurisé à Focalboard via internet, nous utiliserons Nginx comme proxy inverse. Installons et configurons Nginx :

1. Installez Nginx en utilisant la commande suivante :

sudo apt-get install nginx -y

2. Une fois Nginx installé, créez un fichier de configuration d’hôte virtuel pour Focalboard :

sudo nano /etc/nginx/conf.d/focalboard.conf

3. Ajoutez la configuration suivante au fichier :

upstream focalboard {
server localhost:8000;
keepalive 32;
}

server {
listen 80;
server_name focalboard.example.com;

location ~ /ws/* {
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
client_max_body_size 50M;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Frame-Options SAMEORIGIN;
proxy_buffers 256 16k;
proxy_buffer_size 16k;
client_body_timeout 60;
send_timeout 300;
lingering_timeout 5;
proxy_connect_timeout 1d;
proxy_send_timeout 1d;
proxy_read_timeout 1d;
proxy_pass http://focalboard;
}

location / {
client_max_body_size 50M;
proxy_set_header Connection "";
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Frame-Options SAMEORIGIN;
proxy_buffers 256 16k;
proxy_buffer_size 16k;
proxy_read_timeout 600s;
proxy_cache_revalidate on;
proxy_cache_min_uses 2;
proxy_cache_use_stale timeout;
proxy_cache_lock on;
proxy_http_version 1.1;
proxy_pass http://focalboard;
}
}

4. Vérifiez la configuration de Nginx pour détecter les erreurs de syntaxe :

sudo nginx -t

Si la configuration est valide, vous devriez voir nginx: configuration file /etc/nginx/nginx.conf test is successful.

5. Redémarrez Nginx pour appliquer les modifications de configuration :

sudo systemctl restart nginx

6. Vérifiez l’état de Nginx :

sudo systemctl status nginx

Si tout est configuré correctement, vous devriez voir le statut active (running).

Étape 5: Accéder à l’interface Web de Focalboard

Maintenant que Focalboard et Nginx sont configurés, vous pouvez accéder à l’interface web de Focalboard en utilisant votre nom de domaine. Suivez les étapes suivantes :

1. Ouvrez votre navigateur web et entrez l’URL http://focalboard.example.com/login (remplacez focalboard.example.com par votre vrai nom de domaine).
2. Vous serez redirigé vers la page de connexion de Focalboard. Cliquez sur le bouton “Créer un compte”.
3. Remplissez les détails requis, y compris votre adresse e-mail, le nom d’utilisateur de l’administrateur, et le mot de passe. Cliquez sur le bouton “Register” pour créer votre compte Focalboard.
4. Après l’inscription réussie, vous serez redirigé vers le tableau de bord de Focalboard. De là, vous pouvez commencer à gérer et à suivre vos projets.

Étape 6: Activer SSL sur Focalboard

Pour assurer la sécurité de votre installation de Focalboard, il est recommandé d’activer SSL en utilisant Let’s Encrypt. Suivez les étapes ci-dessous pour installer et configurer SSL sur Focalboard :

1. Installez le paquet client Certbot :

sudo apt-get install python3-certbot-nginx -y

2. Une fois l’installation terminée, exécutez la commande suivante pour obtenir et installer le certificat SSL de Let’s Encrypt :

sudo certbot --nginx -d focalboard.example.com

Remplacez focalboard.example.com par votre vrai nom de domaine.

3. Suivez les invites pour entrer une adresse e-mail valide et accepter les conditions d’utilisation.
4. Choisissez de rediriger ou non le trafic HTTP vers HTTPS. Sélectionnez l’option 2 pour rediriger tout le trafic vers HTTPS.
5. Let’s Encrypt gérera automatiquement l’installation et la configuration du certificat pour vous.

Félicitations ! Vous avez réussi à installer et à configurer Focalboard sur votre serveur Ubuntu 22.04 avec Nginx comme proxy inverse. Vous pouvez maintenant accéder en toute sécurité à Focalboard en utilisant votre nom de domaine et commencer à gérer vos projets de manière efficace.

Shape.host offre des solutions d’hébergement Cloud VPS fiables et évolutives pour alimenter votre installation de Focalboard. Profitez des avantages d’une infrastructure cloud à haute performance et d’un support client exceptionnel. Visitez Shape.host pour explorer nos services d’hébergement et commencer votre voyage dans le cloud aujourd’hui.

Christian Wells