Business Digital

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

9 دقائق للقراءة

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.

Sommaire

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.

Ancrage local : Sénégal, Côte d’Ivoire, Mali

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.

Lectures complémentaires

Pourquoi BookStack reste le meilleur wiki self-hosted en 2026

Notion coute 8 USD par utilisateur par mois sur le plan Plus, soit environ 4 800 FCFA / utilisateur / mois — pour une equipe de 15 personnes a Dakar ou Abidjan, c’est 72 000 FCFA mensuels qui partent vers une plateforme americaine ou vos donnees ne vous appartiennent pas. BookStack est l’alternative open source la plus mure en 2026 — interface familiere type Confluence, structure logique en livres / chapitres / pages, recherche full-text, editeur WYSIWYG ET Markdown, le tout deployable en 15 minutes sur un VPS a 2 960 FCFA / mois.

BookStack est developpe par Dan Brown depuis 2015, version stable 26.x en 2026, et utilise par Adobe, NASA et plus de 30 000 organisations dans le monde. Sa stack PHP 8.3 / Laravel 11 / MariaDB le rend leger et facile a maintenir.

Etape 1 — Choisir le VPS et preparer Ubuntu 24.04 LTS

Un Hetzner CX22 a 4,51 EUR / mois (environ 2 960 FCFA) avec 4 Go RAM et 40 Go SSD suffit largement pour une instance BookStack avec 50 utilisateurs et 5 000 pages. Choisissez un datacenter Helsinki ou Falkenstein pour la latence vers l’Afrique de l’Ouest (environ 110 a 130 ms). Connectez-vous en root, mettez a jour puis creez un utilisateur sudo dedie.

apt update && apt upgrade -y
adduser bookadmin
usermod -aG sudo bookadmin

Reconnectez-vous sous le nouvel utilisateur et desactivez le login root SSH dans /etc/ssh/sshd_config. C’est la base du durcissement avant toute installation de service public.

Etape 2 — Installer la stack LEMP avec PHP 8.3

BookStack 26 requiert PHP 8.2 minimum. Utilisez le PPA Ondrej pour PHP 8.3 stable.

sudo apt install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php -y
sudo apt install nginx mariadb-server php8.3-fpm php8.3-cli php8.3-mysql php8.3-curl php8.3-mbstring php8.3-xml php8.3-zip php8.3-gd php8.3-tidy git composer -y

Verifiez les versions avec php -v (doit afficher 8.3) et nginx -v. Si une dependance manque, BookStack le signalera lors de l’install via Composer.

Etape 3 — Creer la base MariaDB dediee

N’utilisez jamais root MariaDB pour une application web. Creez une base et un user dedies.

sudo mysql -e "CREATE DATABASE bookstack CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
sudo mysql -e "CREATE USER 'bookuser'@'localhost' IDENTIFIED BY 'MOT_DE_PASSE_FORT_24CHARS';"
sudo mysql -e "GRANT ALL ON bookstack.* TO 'bookuser'@'localhost';"
sudo mysql -e "FLUSH PRIVILEGES;"

Notez le mot de passe dans votre gestionnaire (Bitwarden self-hosted ou KeePassXC) — vous en aurez besoin a l’etape suivante. Generez-le avec openssl rand -base64 24 pour eviter les mots de passe faibles.

Etape 4 — Cloner BookStack et installer les dependances

Le code source est sur GitHub. Clonez la branche release et installez via Composer en mode production.

cd /var/www
sudo git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch
sudo chown -R www-data:www-data BookStack
cd BookStack
sudo -u www-data composer install --no-dev --optimize-autoloader

L’installation prend environ 2 minutes selon la latence reseau. Si Composer demande l’authentification GitHub, ignorez — le repo est public.

Etape 5 — Configurer le fichier .env

BookStack lit toute sa configuration depuis .env. Copiez le template puis editez les variables critiques.

sudo -u www-data cp .env.example .env
sudo -u www-data php artisan key:generate
sudo nano .env

Renseignez APP_URL=https://wiki.exemple.sn, les credentials DB DB_USERNAME=bookuser et DB_PASSWORD=..., et activez le cache Redis si vous l’avez installe. Lancez ensuite les migrations avec sudo -u www-data php artisan migrate --force.

Etape 6 — Configurer Nginx avec HTTPS Let’s Encrypt

Creez le vhost Nginx avec PHP-FPM en backend.

server {
  listen 80;
  server_name wiki.exemple.sn;
  root /var/www/BookStack/public;
  index index.php;
  location / { try_files $uri $uri/ /index.php?$query_string; }
  location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
  }
}

Activez avec sudo ln -s /etc/nginx/sites-available/bookstack /etc/nginx/sites-enabled/, testez avec sudo nginx -t puis lancez Certbot — sudo certbot --nginx -d wiki.exemple.sn. En 30 secondes votre wiki est en HTTPS.

Etape 7 — Premier login et premier livre de test

Ouvrez https://wiki.exemple.sn dans le navigateur. Connectez-vous avec les identifiants par defaut admin@admin.com / password puis changez-les immediatement dans Settings > Users. Creez votre premiere bibliotheque (Shelf) puis votre premier livre — par exemple Procedures internes 2026. La structure Shelf > Book > Chapter > Page reproduit la logique d’une vraie etagere physique, intuitive pour des utilisateurs non techniques.

Etape 8 — Activer SSO avec Authentik ou Google Workspace

BookStack supporte SAML 2.0 et OIDC nativement. Pour brancher Authentik, ajoutez ces lignes dans .env.

AUTH_METHOD=oidc
OIDC_NAME=Authentik
OIDC_ISSUER=https://auth.exemple.sn/application/o/bookstack/
OIDC_CLIENT_ID=bookstack
OIDC_CLIENT_SECRET=...

Cote Authentik, creez un provider OIDC avec le bon redirect URI https://wiki.exemple.sn/oidc/callback. Au prochain login l’utilisateur est redirige vers Authentik et revient authentifie sans saisir de mot de passe BookStack.

Etape 9 — Sauvegardes automatisees vers S3 ou MinIO

Une perte de la base MariaDB efface tout le contenu — programmez un dump quotidien vers un bucket S3 ou MinIO distant.

0 3 * * * mysqldump -u bookuser -pPASSWORD bookstack | gzip | mc pipe minio/wiki-backups/bookstack-$(date +\%F).sql.gz
0 4 * * * tar -czf - /var/www/BookStack/storage/uploads | mc pipe minio/wiki-backups/uploads-$(date +\%F).tar.gz

Le premier cron sauvegarde la base, le second les uploads (images, fichiers attaches). Conservez 30 jours et testez la restauration tous les trois mois sur un VPS de test.

Etape 10 — Activer la recherche full-text et les notifications email

BookStack indexe automatiquement le contenu pour la recherche. Pour des grosses bases (10 000+ pages), forcez la reindexation periodique via sudo -u www-data php artisan bookstack:regenerate-search. Configurez les emails dans .env via Mailgun ou Brevo (300 emails / jour gratuits) pour les notifications de modification de page.

Cout total et comparaison Notion sur 12 mois

BookStack auto-heberge revient a environ 36 000 FCFA / an (VPS + sauvegardes + domaine). Notion Plus pour 15 utilisateurs facture 864 000 FCFA / an. Economie nette de 828 000 FCFA tout en gardant la souverainete totale des donnees. Le temps d’installation initial — 30 minutes la premiere fois — est rentabilise des le deuxieme mois.

Lectures complémentaires, consultez notre guide Authentik SSO pour vos apps SaaS et notre tutoriel installer Caddy HTTPS automatique.

مشاركة
#2026 #francophone afrique #ouest-afrique-tech #PME #Tutoriel

مقالات مشابهة