Dokumentation deines Homelabs mit BookStack

Mit der Zeit installiert man viele Anwendungen auf dem eigenen Homeserver, eignet sich neues Wissen an und lernt diverse Tipps und Tricks. Meine Empfehlung: Schreibt euch alles auf. Das ist entweder zum Nachschlagen oder auch im Fall eines Datenverlustes sehr hilfreich. Vorausgesetzt, dass man ein Backup seines Homeservers hat.

Eine meiner ersten Anwendungen war daher ein Wiki, wo ich alles einfach und strukturiert notieren konnte. Auf der Suche nach einer einfachen Lösung (einfach im Sinne von einfach installieren und einfach bedienen) bin ich auf BookStack gestoßen.

Kurzbeschreibung

BookStack ist eine kostenlose und quelloffene Wiki-Software mit folgenden Hauptmerkmalen:

  • Einfache Benutzeroberfläche mit WYSIWYG-Editor
  • Strukturierung des Inhalts in Bücher, Kapitel und Seiten
  • Vollständig durchsuchbar mit Verlinkungsmöglichkeiten
  • Konfigurierbare Einstellungen für Name, Logo und Zugriff
  • Integrierter diagrams.net-Editor für Diagramme
  • Mehrsprachig mit vielen verfügbaren Sprachen
  • Optionaler Markdown-Editor mit Vorschau
  • Verschiedene Authentifizierungsmöglichkeiten (soziale Medien, LDAP, etc.)
  • Leistungsstarke Funktionen wie buchübergreifende Sortierung und Seitenversionen
  • Mehrstufige Authentifizierung (MFA)
  • Helles und dunkles Design

Installation

Bookstack kann als Dockeranwendung innerhalb von Minuten über Portainer installiert werden.

Docker-Compose

services:
  bookstack:
    image: lscr.io/linuxserver/bookstack
    container_name: bookstack
    environment:
      - PUID=1000
      - PGID=1000
      - APP_URL=http://192.168.178.60:6875
      - DB_HOST=bookstack_db
      - DB_USER=bookstack
      - DB_PASS=PASSWORT1
      - DB_DATABASE=bookstackapp
    volumes:
      - /var/lib/docker/volumes/bookstack/_data:/config
    ports:
      - 6875:80
    restart: unless-stopped
    depends_on:
      - bookstack_db
  bookstack_db:
    image: lscr.io/linuxserver/mariadb
    container_name: bookstack_db
    environment:
      - PUID=1000
      - PGID=1000
      - MYSQL_ROOT_PASSWORD=PASSWORT2
      - TZ=Europe/Berlin
      - MYSQL_DATABASE=bookstackapp
      - MYSQL_USER=bookstack
      - MYSQL_PASSWORD=GLEICHES PASSWORT1 WIE OBEN
    volumes:
      - /var/lib/docker/volumes/bookstack/_data:/config
    restart: unless-stopped