Installation NodeBB · 9 min read · Oct 19, 2025

Comment installer le forum NodeBB sur Ubuntu 18.04 LTS

NodeBB est un logiciel de forum basé sur Node.js conçu pour le web moderne. Il est construit sur une base de données MongoDB ou Redis. Il utilise des sockets web pour des interactions instantanées et des notifications en temps réel. NodeBB dispose de nombreuses fonctionnalités modernes prêtes à l’emploi telles que l’intégration des réseaux sociaux et les discussions en streaming. Des fonctionnalités supplémentaires sont activées grâce à l’utilisation de plugins tiers. NodeBB est un projet open source que l’on peut trouver sur Github. Dans ce guide, nous vous guiderons étape par étape à travers le processus d’installation de NodeBB sur le système d’exploitation Ubuntu 18.04 LTS en utilisant Nginx comme proxy inverse, MongoDB comme base de données et acme.sh et Let’s Encrypt pour HTTPS.

Exigences

NodeBB nécessite les logiciels suivants à être installés :

  • Node.js version 6 ou supérieure
  • MongoDB version 2.6 ou supérieure ou Redis version 2.8.9 ou supérieure
  • Nginx version 1.3.13 ou supérieure
  • Git

REMARQUE : L’installation des dépendances de NodeBB peut nécessiter plus de 512 mégaoctets de mémoire système. Il est recommandé d’activer une partition d’échange pour compenser si votre système Linux a une mémoire insuffisante.

Prérequis

  • Un système Ubuntu 18.04 en cours d’exécution avec au moins 1 Go de RAM.
  • Nom de domaine avec des enregistrements A / AAAA configurés.
  • Un utilisateur non-root avec des privilèges sudo.

Étapes initiales

Vérifiez votre version d’Ubuntu :

lsb_release -ds  
# Ubuntu 18.04.1 LTS

Configurez le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mettez à jour les paquets de votre système d’exploitation (logiciel). C’est une première étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les paquets logiciels par défaut de votre système d’exploitation :

sudo apt update && sudo apt upgrade -y

Installez quelques paquets essentiels nécessaires à l’administration de base du système d’exploitation Ubuntu :

sudo apt install -y curl wget vim git unzip socat bash-completion

Étape 1 : Installer Node.js et npm

NodeBB est construit sur Node.js. Nous allons installer la version recommandée pour NodeBB qui est la version 8 ** au moment de la rédaction de ce document. Sur Linux, vous avez quelques options d’installation de Node.js : Binaries Linux (x86/x64), Code source ou via des gestionnaires de paquets. Nous allons utiliser l’option de gestion des paquets qui facilite l’installation et la mise à jour de Node.js.

Téléchargez et installez la dernière version Long-Term Support (LTS) de Node.js depuis le dépôt Nodesource :

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -  
sudo apt install -y nodejs

Pour compiler et installer des modules natifs à partir de npm, vous devrez également peut-être installer des outils de construction :

sudo apt install -y build-essential

REMARQUE : npm est distribué avec Node.js - ce qui signifie que lorsque vous téléchargez Node.js, vous obtenez automatiquement npm installé sur votre système.

Vérifiez les versions de Node.js et npm :

node -v && npm -v  
# v10.15.1  
# 6.4.1

Npm est un projet distinct de Node.js, et a tendance à se mettre à jour plus fréquemment. En conséquence, même si vous venez de télécharger Node.js (et donc npm), vous devrez probablement mettre à jour votre npm. Heureusement, npm sait comment se mettre à jour ! Pour mettre à jour votre npm, tapez ceci dans votre terminal : 

sudo npm install -g npm@latest

Cette commande mettra à jour npm vers la dernière version stable.

Vérifiez à nouveau la version de npm avec :

npm -v  
# 6.7.0

Et cela devrait renvoyer les derniers numéros de version.

Étape 2 : Installer et configurer MongoDB

NodeBB a besoin d’une base de données pour stocker ses données, et il prend en charge MongoDB et Redis. Dans ce tutoriel, nous avons choisi MongoDB comme moteur de stockage de données. Donc, dans les étapes suivantes, nous allons télécharger et installer la base de données MongoDB à partir du dépôt rpm officiel de MongoDB :

Pour installer la version stable du paquet MongoDB, exécutez la commande suivante :

sudo apt install -y mongodb

Vérifiez la version de MongoDB :

mongo --version | head -n 1 && mongod --version | head -n 1

Démarrez et activez ( définissez-le pour démarrer au redémarrage) le service MongoDB :

sudo systemctl start mongodb.service  
sudo systemctl enable mongodb.service

Vérifiez l’état du serveur de base de données MongoDB en exécutant :

sudo systemctl status mongodb.service  
# active (en cours d'exécution)

Ensuite, créez une base de données MongoDB et un utilisateur pour NodeBB.

Connectez-vous d’abord au serveur MongoDB.

mongo

Passez à la base de données admin intégrée.

> use admin

Créez un utilisateur administratif.

> db.createUser( { user: "admin", pwd: "", roles: [ { role: "readWriteAnyDatabase", db: "admin" }, { role: "userAdminAnyDatabase", db: "admin" } ] } )

REMARQUE : Remplacez le placeholder par votre propre mot de passe choisi.

Ajoutez une nouvelle base de données appelée nodebb.

> use nodebb

La base de données sera créée et le contexte sera changé vers nodebb. Ensuite, créez l’utilisateur nodebb avec les privilèges appropriés.

> db.createUser( { user: "nodebb", pwd: "", roles: [ { role: "readWrite", db: "nodebb" }, { role: "clusterMonitor", db: "admin" } ] } )

REMARQUE : Encore une fois, remplacez le placeholder par votre propre mot de passe choisi.

Quittez le shell Mongo.

> quit()

Redémarrez MongoDB et vérifiez que l’utilisateur administratif créé précédemment peut se connecter.

sudo systemctl restart mongodb.service  
mongo -u admin -p your_password --authenticationDatabase=admin

Si tout s’est bien passé, votre MongoDB devrait être installé et préparé pour NodeBB. Dans l’étape suivante, nous allons nous occuper de l’installation et de la configuration du serveur web.

Étape 3 - Installer le client acme.sh et obtenir le certificat Let’s Encrypt ( optionnel)

Sécuriser votre forum NodeBB avec HTTPS n’est pas nécessaire, mais c’est une bonne pratique pour sécuriser le trafic de votre site. Afin d’obtenir un certificat TLS de Let’s Encrypt, nous allons utiliser le client acme.sh. Acme.sh est un logiciel shell unix pur pour obtenir des certificats TLS de Let’s Encrypt sans dépendances.

Téléchargez et installez acme.sh :

sudo su - root  
git clone https://github.com/Neilpang/acme.sh.git  
cd acme.sh   
./acme.sh --install --accountemail [email protected]  
source ~/.bashrc  
cd ~

Vérifiez la version de acme.sh :

acme.sh --version  
# v2.8.0

Obtenez des certificats RSA et ECC/ECDSA pour votre domaine/nom d’hôte : 

# RSA 2048  
acme.sh --issue --standalone -d example.com --keylength 2048  
# ECDSA  
acme.sh --issue --standalone -d example.com --keylength ec-256

Si vous souhaitez des certificats factices pour les tests, vous pouvez ajouter le drapeau --staging aux commandes ci-dessus.

Après avoir exécuté les commandes ci-dessus, vos certificats et clés seront dans :

  • Pour RSA : le répertoire /home/username/example.com.
  • Pour ECC/ECDSA : le répertoire /home/username/example.com_ecc.

Pour lister vos certificats émis, vous pouvez exécuter :

acme.sh --list

Créez un répertoire pour stocker vos certificats. Nous allons utiliser le répertoire /etc/letsencrypt.

mkdir -p /etc/letsecnrypt/example.com  
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Installez/copiez les certificats dans le répertoire /etc/letsencrypt.

# RSA  
acme.sh --install-cert -d example.com --cert-file /etc/letsencrypt/example.com/cert.pem --key-file /etc/letsencrypt/example.com/private.key --fullchain-file /etc/letsencrypt/example.com/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"  
# ECC/ECDSA  
acme.sh --install-cert -d example.com --ecc --cert-file /etc/letsencrypt/example.com_ecc/cert.pem --key-file /etc/letsencrypt/example.com_ecc/private.key --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem --reloadcmd "sudo systemctl reload nginx.service"

Tous les certificats seront automatiquement renouvelés tous les 60 jours.

Après avoir obtenu les certificats, quittez l’utilisateur root et revenez à l’utilisateur sudo normal :

exit

Étape 4 : Installer et configurer Nginx

NodeBB peut fonctionner correctement avec de nombreux serveurs web. Dans ce tutoriel, nous avons sélectionné Nginx.

Installez le paquet Nginx, en exécutant la commande suivante :

sudo apt install -y nginx

Après l’installation, vous pouvez vérifier la version de Nginx en exécutant :

nginx -v

Démarrez et activez ( définissez-le pour démarrer au redémarrage) le service Nginx :

sudo systemctl start nginx.service  
sudo systemctl enable nginx.service

Vérifiez l’état du serveur web Nginx en exécutant :

sudo systemctl status nginx.service  
# active (en cours d'exécution)

NodeBB fonctionne par défaut sur le port 4567. Pour éviter de taper http://example.com:4567, nous allons configurer Nginx comme un proxy inverse pour l’application NodeBB. Chaque requête sur le port 80 ou 443 ( si SSL est utilisé) sera redirigée vers le port 4567.

Exécutez sudo vim /etc/nginx/conf.d/nodebb.conf et configurez Nginx comme un proxy inverse HTTPS.

server {  
  listen [::]:443 ssl http2;  
  listen 443 ssl http2;  
  listen [::]:80;  
  listen 80;  
  
  server_name example.com;  
  
  client_max_body_size 50M;  
  
  # RSA  
  ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;  
  ssl_certificate_key /etc/letsencrypt/example.com/private.key;  
  # ECDSA  
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;  
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;  
  
  location / {  
    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 Host $http_host;  
    proxy_set_header X-NginX-Proxy true;  
    proxy_pass http://127.0.0.1:4567;  
    proxy_redirect off;  
    # Support Socket.IO  
    proxy_http_version 1.1;  
    proxy_set_header Upgrade $http_upgrade;  
    proxy_set_header Connection "upgrade";   
  }  
  
}

Vérifiez la configuration de Nginx :

sudo nginx -t

Enfin, pour que les changements prennent effet, nous devons recharger Nginx :

sudo systemctl reload nginx.service

Étape 5 : Installer et configurer NodeBB

Créez un répertoire racine de documents où NodeBB devrait résider :

sudo mkdir -p /var/www/nodebb

Naviguez vers le répertoire racine des documents :

cd /var/www/nodebb

Changez la propriété du répertoire /var/www/nodebb à votre_utilisateur.

sudo chown -R [your_user]:[your_user] /var/www/nodebb

REMARQUE : Remplacez your_user dans la commande ci-dessus par votre utilisateur non-root que vous devriez avoir créé comme prérequis pour ce tutoriel .

Clonez le dernier dépôt NodeBB dans le dossier racine des documents :

git clone -b v1.11.x https://github.com/NodeBB/NodeBB.git .

Initiez le script de configuration en exécutant l’application avec le drapeau setup. Répondez à chacune des questions :

./nodebb setup

Après que la configuration de NodeBB soit terminée, exécutez ./nodebb start pour démarrer manuellement votre serveur NodeBB :

./nodebb start

Après avoir exécuté cette commande, vous devriez être en mesure d’accéder à votre tout nouveau forum dans votre navigateur web :

NodeBB dans le navigateur

Étape 6 : Exécuter NodeBB en tant que service système

Lorsqu’il est démarré via ./nodebb start, NodeBB ne redémarrera pas automatiquement lorsque le système redémarre. Pour éviter cela, nous devons configurer NodeBB en tant que service système.

Si NodeBB est en cours d’exécution, arrêtez-le :

./nodebb stop

Créez un nouvel utilisateur nodebb :

sudo useradd nodebb

Changez la propriété du répertoire /var/www/nodebb à l’utilisateur nodebb :

sudo chown -R nodebb:nodebb /var/www/nodebb

Créez un fichier de configuration d’unité systemd nodebb.service. Ce fichier d’unité gérera le démarrage du démon NodeBB. Exécutez sudo vim /etc/systemd/system/nodebb.service et ajoutez le contenu ci-dessous :

[Unit]
Description=NodeBB
Documentation=https://docs.nodebb.org
After=system.slice multi-user.target mongod.service

[Service]
Type=forking
User=nodebb

StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=nodebb

Environment=NODE_ENV=production
WorkingDirectory=/var/www/nodebb
PIDFile=/var/www/nodebb/pidfile
ExecStart=/usr/bin/env node loader.js
Restart=always

[Install]
WantedBy=multi-user.target

REMARQUE : Définissez le nom d’utilisateur et les chemins de répertoire selon vos noms choisis.

Activez nodebb.service au démarrage et démarrez immédiatement nodebb.service :

sudo systemctl enable nodebb.service  
sudo systemctl start nodebb.service

Vérifiez l’état de nodebb.service :

sudo systemctl status nodebb.service  
sudo systemctl is-enabled nodebb.service

Félicitations ! Vous avez réussi à installer et déployer la plateforme de discussion NodeBB sur le système Ubuntu 18.04. Vous devriez être en mesure d’accéder à votre forum sur votre domaine et d’interagir avec votre forum.

Liens

Share: X/Twitter LinkedIn
#Installation NodeBB

Recevez de nouveaux articles dans votre boîte de réception.

Aucun spam. Désabonnez-vous à tout moment.