Colas Mérand
30/06/2025
BookStack
Plesk
Debian
5 minutes
Dans un monde professionnel où la documentation technique et le partage de connaissances sont devenus essentiels, BookStack s'impose comme une solution open-source particulièrement efficace. Cette plateforme de documentation, souvent comparée à un "wiki" moderne, permet de structurer l'information de manière intuitive en livres, chapitres et pages, facilitant ainsi la navigation et la recherche.
Chez Platane, nous avons accompagné plusieurs organisations dans la mise en place de solutions de gestion documentaire adaptées à leurs besoins spécifiques. Notre expérience nous a montré que BookStack représente un excellent compromis entre simplicité d'utilisation et puissance fonctionnelle.
Avant de commencer l'installation proprement dite, assurez-vous de disposer des éléments suivants :
Commencez par mettre à jour votre système et installer les dépendances nécessaires :
sudo apt update
sudo apt upgrade -y
sudo apt install -y git unzip nginx php7.4-fpm php7.4-mbstring php7.4-curl php7.4-xml php7.4-zip php7.4-gd php7.4-mysql mariadb-server composer
Créez une base de données et un utilisateur dédié pour BookStack :
sudo mysql -u root -p
Dans l'invite MySQL, exécutez :
CREATE DATABASE bookstack;
CREATE USER 'bookstack'@'localhost' IDENTIFIED BY 'votre_mot_de_passe_sécurisé';
GRANT ALL ON bookstack.* TO 'bookstack'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Clonez le dépôt GitHub de BookStack dans le répertoire de votre choix :
cd /var/www
sudo git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch bookstack
cd bookstack
Copiez le fichier d'environnement exemple et configurez-le :
sudo cp .env.example .env
sudo nano .env
Modifiez les paramètres suivants dans le fichier .env :
APP_URL=https://votre-domaine.com
DB_DATABASE=bookstack
DB_USERNAME=bookstack
DB_PASSWORD=votre_mot_de_passe_sécurisé
sudo composer install --no-dev
sudo php artisan key:generate
sudo php artisan migrate
sudo chown -R www-data:www-data /var/www/bookstack
sudo chmod -R 755 /var/www/bookstack
Dans l'interface Plesk, créez un nouveau domaine ou sous-domaine pour votre instance BookStack. Ensuite, configurez un hôte virtuel Nginx avec les paramètres suivants :
server {
listen 80;
server_name votre-domaine.com;
root /var/www/bookstack/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
}
}
N'oubliez pas de configurer HTTPS avec Let's Encrypt via l'interface Plesk pour sécuriser votre instance.
La protection de vos données est primordiale. Nous recommandons de mettre en place une stratégie de sauvegarde régulière incluant :
# Sauvegarde de la base de données
mysqldump -u bookstack -p bookstack > /chemin/vers/sauvegarde/bookstack_$(date +%Y%m%d).sql
# Sauvegarde des fichiers
rsync -av --delete /var/www/bookstack/ /chemin/vers/sauvegarde/bookstack/
Ces commandes peuvent être intégrées dans un script cron pour automatiser le processus.
BookStack peut être optimisé pour de meilleures performances en ajustant quelques paramètres dans le fichier .env :
CACHE_DRIVER=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
N'oubliez pas d'installer Redis si vous optez pour cette configuration :
sudo apt install -y redis-server php7.4-redis
sudo systemctl enable redis-server
L'une des forces de BookStack est sa capacité à s'intégrer avec d'autres outils. Lors d'un récent projet pour un client du secteur technologique, nous avons développé une intégration personnalisée entre BookStack et leur système de gestion de projet existant. Cette approche a permis de centraliser la documentation technique tout en maintenant une synchronisation avec les tickets et les tâches en cours.
Notre équipe a également mis en place une solution similaire pour Epictory, où nous avons intégré une documentation technique complète basée sur BookStack avec leur infrastructure existante, facilitant ainsi la collaboration entre les équipes de développement et de design.
BookStack offre de nombreuses possibilités de personnalisation. Pour plusieurs de nos clients, nous avons développé des thèmes sur mesure qui respectent leur charte graphique. Cette personnalisation peut être réalisée en modifiant les fichiers CSS et en ajoutant des scripts JavaScript personnalisés.
Pour le Centre Pompidou, nous avons par exemple créé une interface de documentation technique qui s'intégrait parfaitement à leur écosystème numérique existant, tout en conservant la simplicité d'utilisation caractéristique de BookStack.
La maintenance régulière de votre instance BookStack est essentielle pour garantir sa sécurité et ses performances. Voici la procédure recommandée pour les mises à jour :
cd /var/www/bookstack
sudo git pull origin release
sudo composer install --no-dev
sudo php artisan migrate
sudo php artisan cache:clear
sudo php artisan view:clear
sudo chown -R www-data:www-data /var/www/bookstack
BookStack représente une solution robuste et flexible pour la gestion documentaire en entreprise. Sa structure intuitive, ses fonctionnalités de recherche avancées et sa facilité d'utilisation en font un outil de choix pour centraliser et partager les connaissances au sein d'une organisation.
Chez Platane, nous avons développé une expertise approfondie dans le déploiement et la personnalisation de solutions de documentation comme BookStack. Notre approche combine une maîtrise technique des infrastructures serveur avec une compréhension fine des besoins métier en matière de gestion documentaire.
Que vous soyez une startup en pleine croissance ou une entreprise établie, la mise en place d'une solution de documentation efficace peut considérablement améliorer la productivité de vos équipes et faciliter l'intégration de nouveaux collaborateurs.
Vous avez un projet d'installation ou de migration vers BookStack ? Vous souhaitez explorer les possibilités d'intégration avec vos systèmes existants ? N'hésitez pas à prendre rendez-vous via notre formulaire de contact. Notre équipe d'experts se fera un plaisir d'échanger avec vous sur votre projet et de vous proposer une solution adaptée à vos besoins spécifiques.
Collaborer avec Platane, c'est bénéficier d'un accompagnement personnalisé, d'une expertise technique reconnue et d'une approche créative pour transformer vos défis en opportunités. Contactez-nous dès aujourd'hui pour donner vie à votre projet de gestion documentaire.
Vous préférez discuter de vive voix ? Nous aussi et c'est évidemment sans engagement !
Une question, un besoin de renseignements ? N'hésitez pas à nous contacter.