Comment Auto-Héberger BookStack sur un VPS (Guide Complet)

BookStack est une plateforme simple et auto-hébergée pour organiser et stocker de la documentation. Si vous êtes développeur ou passionné d’informatique cherchant à auto-héberger BookStack sur un VPS, ce guide vous expliquera le processus d’installation étape par étape. Nous allons explorer l’installation en utilisant Docker, ce qui simplifie le déploiement et la gestion des applications.

Pourquoi Utiliser BookStack ?

BookStack vous permet de créer facilement une documentation de type wiki, avec des fonctionnalités telles que :

• Pages imbriquées
• Support de Markdown
• Rôles et autorisations utilisateurs
• Capacités de recherche intégrées

Cela fait de BookStack un choix idéal pour quiconque cherchant à créer et maintenir de la documentation pour des projets ou un usage personnel.

Choisir un Fournisseur de VPS

Il existe plusieurs fournisseurs de VPS parmi lesquels choisir en fonction de votre budget et de vos besoins. Voici une comparaison rapide des fournisseurs populaires :

Lorsque vous choisissez un fournisseur de VPS, prenez en compte des facteurs tels que le prix, la performance et la facilité d’utilisation. Si vous n’êtes pas certain, consultez notre comparaison complète des VPS pour plus d’options.

Préparer Votre VPS

1. Déployez Votre VPS : Choisissez un fournisseur dans le tableau et configurez votre VPS. Sélectionnez votre distribution Linux préférée (Ubuntu/Debian est recommandé).

2. Accédez à Votre Serveur : Utilisez SSH pour vous connecter à votre serveur. Vous pouvez utiliser une application terminal comme PuTTY ou le terminal de votre système.

   ssh username@your_vps_ip

3. Mettez à Jour Votre Système : Gardez toujours votre système à jour.

   sudo apt update && sudo apt upgrade -y

Installer Docker

BookStack peut être facilement exécuté avec Docker. Installez Docker en exécutant les commandes suivantes :

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Vous pouvez vérifier l’installation en vérifiant la version de Docker :

docker --version

Installer Docker Compose

Docker Compose est un outil pour définir et exécuter des applications Docker multi-conteneurs. Installez Docker Compose avec les commandes suivantes :

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Vérifiez que Docker Compose est installé :

docker-compose --version

Déployer BookStack

1. Créez un Répertoire pour BookStack :

   mkdir ~/bookstack
   cd ~/bookstack

2. Créez un Fichier docker-compose.yml :

   Utilisez votre éditeur de texte préféré pour créer le fichier :

   nano docker-compose.yml

   Ajoutez la configuration suivante :

   version: '2'
   services:
     bookstack:
       image: solidnerd/bookstack
       ports:
         - "80:80"
       environment:
         - DB_HOST=db
         - DB_USER=bookstack
         - DB_PASS=bookstackpassword
         - DB_DATABASE=bookstack
       depends_on:
         - db
   
     db:
       image: mysql:5.7
       environment:
         - MYSQL_ROOT_PASSWORD=rootpassword
         - MYSQL_DATABASE=bookstack
         - MYSQL_USER=bookstack
         - MYSQL_PASSWORD=bookstackpassword
       volumes:
         - db_data:/var/lib/mysql
   
   volumes:
     db_data:

   Modifiez les mots de passe de la base de données si nécessaire.

3. Démarrez les Conteneurs :

   Exécutez la commande suivante pour démarrer BookStack :

   docker-compose up -d

   Cette commande téléchargera les images nécessaires et les démarrera en mode détaché.

4. Accédez à BookStack :

   Ouvrez votre navigateur web et allez à http://your_vps_ip. Vous devriez voir la page de configuration de BookStack. Suivez les instructions à l’écran pour finir l’installation.

Gérer BookStack

Vous pouvez gérer BookStack via l’interface web. Vous pouvez ajouter des utilisateurs, créer différents livres, chapitres et pages selon vos besoins.

Questions Fréquemment Posées

Q1 : Puis-je exécuter BookStack sans Docker ?

Oui, vous pouvez installer BookStack sans Docker, mais cela nécessite une configuration plus manuelle, y compris la configuration de PHP, MariaDB et d’un serveur web comme Apache ou Nginx. Docker simplifie considérablement le processus, permettant un déploiement et des mises à jour plus faciles.

Q2 : Comment puis-je sauvegarder mon installation de BookStack ?

Pour sauvegarder votre installation de BookStack, vous devez sauvegarder à la fois la base de données et les fichiers de l’application. Vous pouvez réaliser cela en utilisant des commandes Docker pour copier les fichiers de la base de données et sauvegarder les données de votre répertoire BookStack. L’automatisation via des scripts peut encore simplifier le processus de sauvegarde.

Q3 : BookStack est-il sécurisé pour un auto-hébergement ?

BookStack est relativement sécurisé, surtout en auto-hébergement. Il est crucial d’utiliser des mots de passe forts, de garder le logiciel à jour et de configurer des règles de pare-feu appropriées. De plus, l’utilisation du SSL (via Let’s Encrypt ou similaire) aide à garantir un accès sécurisé à votre instance BookStack sur le web.

Conclusion

L’auto-hébergement de BookStack sur un VPS offre une manière puissante de gérer vos besoins en documentation. Avec les étapes décrites dans ce guide, vous pouvez déployer et gérer efficacement votre propre instance de BookStack. N’oubliez pas d’explorer les différentes fonctionnalités de BookStack et de le personnaliser pour répondre à vos besoins à mesure que vous développez votre base de connaissances. Pour d’autres options et comparaisons de fournisseurs de VPS, jetez un œil à notre comparaison complète des VPS. Bon hébergement !