Pourquoi self-héberger BookStack sur un VPS
BookStack se distingue par sa simplicité : là où d'autres wikis noient l'utilisateur sous les options, il impose une hiérarchie claire en étagères, livres, chapitres et pages, ce qui rend la documentation immédiatement navigable. Construit sur le framework Laravel, il est léger et facile à maintenir. Auto-hébergé sur VPS, il garde toute votre documentation interne — procédures, runbooks, base de connaissances client — sur votre propre infrastructure, sans abonnement par utilisateur. Pour une agence qui documente ses projets ou une équipe technique qui centralise ses procédures, c'est un wiki privé que vous contrôlez de bout en bout, avec recherche full-text, gestion fine des permissions et éditeur WYSIWYG ou Markdown.
Bénéfices concrets d'un BookStack auto-hébergé
- Structure claire en étagères/livres/chapitres/pages : documentation navigable sans effort.
- Éditeur WYSIWYG et Markdown au choix, avec diagrammes Draw.io intégrés.
- Permissions granulaires par rôle et par livre pour cloisonner les contenus sensibles.
- Recherche full-text rapide sur l'ensemble de la base de connaissances.
- Authentification LDAP, SAML ou OAuth pour s'intégrer à votre annuaire d'entreprise.
- Empreinte légère : un VPS modeste suffit pour une documentation d'équipe.
Prérequis matériels et logiciels
BookStack est peu exigeant. Un VPS de 1 à 2 vCPU et 2 Go de RAM héberge confortablement la documentation d'une équipe ; la consommation grimpe surtout avec le volume d'images uploadées. Il s'appuie sur MySQL ou MariaDB. Prévoyez 15 à 25 Go de SSD selon la quantité de pièces jointes. Côté logiciel : Docker et Docker Compose, un sous-domaine wiki.votredomaine.ma avec enregistrement A, et un serveur SMTP pour l'envoi des invitations et notifications par e-mail.
Déployer BookStack avec Docker et SSL
Préparer le VPS
Installez Docker et le plugin Compose, puis créez /opt/bookstack. L'image communautaire lscr.io/linuxserver/bookstack est la plus répandue et la mieux maintenue pour un déploiement conteneurisé.
Déclarer MySQL et BookStack
Dans le docker-compose.yml, ajoutez un service mariadb avec une base et un utilisateur dédiés, plus le service bookstack. Renseignez la variable APP_URL en https://wiki.votredomaine.ma — une URL incorrecte casse les liens internes et les uploads.
Lancer la stack
Exécutez docker compose up -d, puis surveillez docker compose logs -f bookstack. Au premier démarrage, BookStack exécute automatiquement les migrations Laravel pour créer le schéma de la base.
Configurer reverse proxy et SSL
Avec Caddy : wiki.votredomaine.ma { reverse_proxy localhost:6875 }, le certificat est géré seul. Avec Nginx, proxifiez vers 127.0.0.1:6875 et obtenez le certificat via certbot --nginx.
Première connexion et SMTP
Connectez-vous avec le compte par défaut admin@admin.com puis changez immédiatement le mot de passe. Configurez les variables SMTP (MAIL_HOST, MAIL_USERNAME...) pour activer les invitations utilisateurs et la réinitialisation de mot de passe.
Soignez votre stratégie de sauvegarde : une instance BookStack se restaure à partir de trois éléments — le dump de la base MySQL/MariaDB, le dossier uploads (images et pièces jointes) et le fichier de configuration contenant la clé APP_KEY. Sans cette clé d'application Laravel, les contenus chiffrés ne pourront pas être déchiffrés après restauration. Automatisez un mysqldump quotidien plus une copie du volume uploads vers un stockage externe, et conservez précieusement l'APP_KEY hors du serveur.
