Outline excelle pour wikis collaboratifs. Mais pour la documentation produit structurée, les manuels de procédures, les runbooks IT, les formations internes, vous voulez une organisation hiérarchique claire : Livres → Chapitres → Pages. BookStack est l’outil de référence open source pour ce besoin. Interface inspirée d’une bibliothèque, recherche full-text puissante, éditeur WYSIWYG ou Markdown, permissions granulaires, audit trail. Auto-hébergé sur Hetzner CX22 à 4,51 €/mois pour 100 utilisateurs.

Pourquoi BookStack en 2026

Cinq raisons concrètes.

Hiérarchie claire. Shelves (étagères) → Books (livres) → Chapters (chapitres) → Pages. Métaphore intuitive pour utilisateurs non-tech. Différent d’Outline plus libre, BookStack guide vers structure rigoureuse.

Coût. 25 utilisateurs Confluence Cloud = 1 800 USD/an. BookStack self-hosted = 54 €/an de VPS. Économie 1 700 USD/an.

Stack PHP/MySQL classique. Stable, bien supporté, facile à backup. Moins moderne que Outline (Node.js/Postgres) mais plus simple à dépanner pour admins WordPress habitués.

Search powerful. Recherche full-text via base SQL avec stemming français/arabe/anglais. Trouve documents par contenu intérieur (PDF/Word attachements indexés aussi).

Permissions granulaires. Au niveau shelf, book, chapter, page. Roles personnalisés. Idéal pour PME avec confidentialité variable selon docs.

Concepts fondamentaux

Shelves, books, chapters, pages

Hiérarchie 4 niveaux :

Shelf (étagère) : groupe thématique de livres. Exemple : « Engineering ».
Book (livre) : sujet majeur. Exemple : « Déploiement Production ».
Chapter (chapitre) : sous-section. Exemple : « VPS Hetzner ».
Page : contenu réel. Exemple : « Configurer un VPS Ubuntu 22.04 ».

Editors WYSIWYG ou Markdown

BookStack offre éditeur WYSIWYG TinyMCE (rich text) et éditeur Markdown CodeMirror. Choix par utilisateur. Markdown préféré pour développeurs, WYSIWYG pour rédacteurs non-tech.

Roles et permissions

Roles préconfigurés : Admin, Editor, Viewer, Public. Custom roles possibles. Permissions par entité : Create, View, Update, Delete.

Audit log

Toutes les actions loggées : qui a edit quoi, quand. Conservation 90 jours par défaut, ajustable. Critique pour conformité ARTCI/CDP.

API REST

Endpoints publics + auth Bearer. Création pages programmatiques, sync depuis GitHub, etc.

Authentication

Local + LDAP + SAML + OIDC + Social (Google, Microsoft, GitHub). Branchement Authentik via OIDC straight-forward.

Vue d’ensemble pratique

1. Déploiement

Coolify + template BookStack + MySQL. 30 min setup. Voir Déployer BookStack sur Coolify.

2. Structure initiale

Créer shelves par département. Voir Organiser shelves, books, chapters.

3. SSO Authentik

Voir SSO Authentik avec BookStack.

4. Permissions et workflow

Voir Permissions et workflow éditorial.

Tutoriels du cluster BookStack

Cas d’usage

Documentation produit SaaS

SaaS B2B à Abidjan : un shelf « Documentation Public » exposé via lien public, et shelf « Internal » privé. Clients accèdent aux guides utilisateur, équipe interne aux PRD.

Manuel procédures cabinet

Cabinet d’avocats à Casablanca : shelf « Procédures Internes » avec books par domaine (commercial, immobilier, social). Chapters par étape. Permissions strictes par associé.

Runbooks IT

ESN à Tunis : shelf « DevOps Runbooks » avec books par stack (Kubernetes, Postgres, Redis). Chapters par incident type. Pages exécutables (commandes, dashboards Grafana).

Formations internes

PME à Dakar onboarding : shelf « Onboarding » avec book par rôle (Dev, Sales, Marketing). Chapters semaines 1-4. Pages quotidiennes.

Knowledge base support client

E-commerce à Cotonou : shelf « FAQ Public » exposé. Book « Paiement Wave », « Livraison », « Retours ». Clients trouvent réponses sans contacter support.

Adaptation au contexte ouest-africain

Quatre adaptations.

Coût. 25 utilisateurs Confluence = 1 800 USD/an. BookStack = 54 €/an. Différence finance formations équipe.

Multilingue. Interface BookStack traduite français, arabe, anglais. Pages multilingues via shelves séparés (FR shelf, AR shelf).

Recherche multilingue. Stemming français + arabe via MySQL FULLTEXT. Recherche cross-langue acceptable.

Connectivité. BookStack PWA installable. Pages récemment consultées en cache local. Utilisable hors-ligne pour pages déjà téléchargées.

Erreurs fréquentes

Erreur	Cause	Solution
Upload images 413	PHP upload limit	Augmenter post_max_size + upload_max_filesize
Recherche FULLTEXT manque mots français	min word length	MySQL ft_min_word_len = 3
SSO échec	OIDC discovery URL	Vérifier endpoints Authentik
Email magic link	SMTP non configuré	Brevo via .env BookStack
Performance lente 1000 pages	Pas d’index MySQL	OPTIMIZE TABLE pages
Backup MySQL oublié	Pas de cron	mysqldump quotidien + restic

FAQ

BookStack vs Outline ? BookStack structuré (Books/Chapters), idéal docs produit. Outline libre, idéal wikis collaboratifs. Choisir selon besoin.

Capacité Hetzner CX22 ? 100 utilisateurs + 10 000 pages confortable.

Mobile app ? PWA officiel, installable iOS/Android.

Migration Confluence ? Outils tiers existent (confluence-to-bookstack scripts). Comptez 1-3 jours pour 1 000 pages.

Multi-tenant ? Pas natif. Workaround : 1 BookStack par client.

Versioning ? Oui, chaque modification crée révision. Restauration en 1 clic.

Export PDF ? Oui par page ou book entier. Templates customisables.

Pour aller plus loin

Démarrer maintenant : Déployer BookStack sur Coolify
Documentation officielle : bookstackapp.com/docs
GitHub : github.com/BookStackApp/BookStack

BookStack 2026 : guide complet (wiki documentaire structuré pour PME francophone)