BookStack

À quoi ça sert ?

BookStack organise la documentation comme une bibliothèque : étagères, livres, chapitres et pages. L'éditeur est visuel, sans code. Idéal pour documenter une maison, une association ou un projet.

Pour qui ?

Ceux qui veulent documenter quelque chose proprement, à plusieurs.

Après l'installation

1. Connectez-vous avec admin@admin.com / password, puis changez immédiatement l’email et le mot de passe.

Le docker-compose

Exemple derrière Traefik, avec une explication sur chaque ligne. Pour l'adapter à votre cas (Nginx Proxy Manager, port local…), utilisez le générateur.

# docker-compose.yml : BookStack
# Ce fichier décrit les « conteneurs » à lancer : chaque conteneur est une petite
# boîte isolée qui contient un programme. Lancez-le avec : docker compose up -d
services:
  # Conteneur principal : l'application BookStack
  bookstack:
    # Le programme à télécharger (l'« image »), avec sa version
    image: lscr.io/linuxserver/bookstack:latest
    container_name: bookstack
    # Redémarre tout seul après une panne ou un redémarrage du serveur
    restart: unless-stopped
    # Démarre ces conteneurs avant celui-ci
    depends_on:
      - db
    # Réglages de l'application. Les valeurs ${...} viennent du fichier .env
    environment:
      PUID: "1000"
      PGID: "1000"
      TZ: Europe/Paris
      APP_URL: https://wiki.mondomaine.fr
      APP_KEY: "${APP_KEY}"
      DB_HOST: db
      DB_PORT: "3306"
      DB_USERNAME: bookstack
      DB_PASSWORD: "${DB_PASSWORD}"
      DB_DATABASE: bookstack
    # Dossiers du serveur partagés avec le conteneur (dossier_serveur:dossier_conteneur).
    # Vos données sont stockées ici : ce sont ces dossiers qu'il faut sauvegarder.
    volumes:
      - ./config:/config
    # Réseau partagé avec le reverse proxy pour qu'il puisse joindre l'application
    networks:
      - traefik
      - default
    # Indique à Traefik de publier l'application sur https://wiki.mondomaine.fr avec un certificat HTTPS
    labels:
      - traefik.enable=true
      - traefik.http.routers.bookstack.rule=Host(`wiki.mondomaine.fr`)
      - traefik.http.routers.bookstack.entrypoints=websecure
      - traefik.http.routers.bookstack.tls.certresolver=letsencrypt
      - traefik.http.services.bookstack.loadbalancer.server.port=80
      - traefik.docker.network=traefik

  # Conteneur annexe « db » (utilisé par l'application, pas accessible de l'extérieur)
  db:
    # Le programme à télécharger (l'« image »), avec sa version
    image: lscr.io/linuxserver/mariadb:latest
    container_name: bookstack-db
    # Redémarre tout seul après une panne ou un redémarrage du serveur
    restart: unless-stopped
    # Réglages de l'application. Les valeurs ${...} viennent du fichier .env
    environment:
      PUID: "1000"
      PGID: "1000"
      TZ: Europe/Paris
      MYSQL_ROOT_PASSWORD: "${DB_ROOT_PASSWORD}"
      MYSQL_DATABASE: bookstack
      MYSQL_USER: bookstack
      MYSQL_PASSWORD: "${DB_PASSWORD}"
    # Dossiers du serveur partagés avec le conteneur (dossier_serveur:dossier_conteneur).
    # Vos données sont stockées ici : ce sont ces dossiers qu'il faut sauvegarder.
    volumes:
      - ./db:/config
# Le réseau du reverse proxy existe déjà : on s'y raccroche

networks:
  traefik:
    external: true