Wie man BookStack auf einem VPS selbst hostet (Komplette Anleitung)

BookStack ist eine einfache, selbst gehostete Plattform zur Organisation und Speicherung von Dokumentation. Wenn Sie ein Entwickler oder ein Homelabber sind, der BookStack auf einem VPS selbst hosten möchte, wird Sie dieser Leitfaden Schritt für Schritt durch den Installationsprozess führen. Wir werden die Installation mit Docker untersuchen, was die Bereitstellung und Verwaltung von Anwendungen vereinfacht.

Warum BookStack verwenden?

BookStack ermöglicht es Ihnen, ganz einfach Dokumentationen im Wiki-Stil zu erstellen, mit Funktionen wie:

• Verschachtelung von Seiten
• Markdown-Unterstützung
• Benutzerrollen und Berechtigungen
• Eingebaute Suchfunktionen

Das macht BookStack zu einer idealen Wahl für jeden, der Dokumentationen für Projekte oder persönliche Zwecke erstellen und pflegen möchte.

Auswahl eines VPS-Anbieters

Es gibt mehrere VPS-Anbieter, aus denen Sie basierend auf Ihrem Budget und Ihren Anforderungen wählen können. Nachfolgend finden Sie einen kurzen Vergleich beliebter Anbieter:

Bei der Auswahl eines VPS-Anbieters sollten Sie Faktoren wie Preis, Leistung und Benutzerfreundlichkeit berücksichtigen. Wenn Sie sich unsicher sind, werfen Sie einen Blick auf unseren vollständigen VPS-Vergleich für weitere Optionen.

Vorbereitung Ihres VPS

1. Setzen Sie Ihren VPS ein: Wählen Sie einen Anbieter aus der Tabelle und richten Sie Ihren VPS ein. Wählen Sie Ihre bevorzugte Linux-Distribution (Ubuntu/Debian wird empfohlen).

2. Zugriff auf Ihren Server: Verwenden Sie SSH, um sich mit Ihrem Server zu verbinden. Sie können eine Terminalanwendung wie PuTTY oder das Terminal Ihres Systems verwenden.

   ssh username@your_vps_ip

3. Aktualisieren Sie Ihr System: Halten Sie Ihr System immer auf dem neuesten Stand.

   sudo apt update && sudo apt upgrade -y

Docker installieren

BookStack kann einfach mit Docker betrieben werden. Installieren Sie Docker, indem Sie die folgenden Befehle ausführen:

sudo apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
sudo apt update
sudo apt install docker-ce -y

Sie können die Installation überprüfen, indem Sie die Docker-Version abfragen:

docker --version

Docker Compose installieren

Docker Compose ist ein Tool zum Definieren und Ausführen von Docker-Anwendungen mit mehreren Containern. Installieren Sie Docker Compose mit den folgenden Befehlen:

sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose

Überprüfen Sie, ob Docker Compose installiert ist:

docker-compose --version

BookStack bereitstellen

1. Erstellen Sie ein Verzeichnis für BookStack:

   mkdir ~/bookstack
   cd ~/bookstack

2. Erstellen Sie eine docker-compose.yml-Datei:

   Verwenden Sie Ihren bevorzugten Texteditor, um die Datei zu erstellen:

   nano docker-compose.yml

   Fügen Sie die folgende Konfiguration hinzu:

   version: '2'
   services:
     bookstack:
       image: solidnerd/bookstack
       ports:
         - "80:80"
       environment:
         - DB_HOST=db
         - DB_USER=bookstack
         - DB_PASS=bookstackpassword
         - DB_DATABASE=bookstack
       depends_on:
         - db
   
     db:
       image: mysql:5.7
       environment:
         - MYSQL_ROOT_PASSWORD=rootpassword
         - MYSQL_DATABASE=bookstack
         - MYSQL_USER=bookstack
         - MYSQL_PASSWORD=bookstackpassword
       volumes:
         - db_data:/var/lib/mysql
   
   volumes:
     db_data:

   Ändern Sie die Datenbank-Passwörter nach Bedarf.

3. Starten Sie die Container:

   Führen Sie den folgenden Befehl aus, um BookStack zu starten:

   docker-compose up -d

   Dieser Befehl lädt die erforderlichen Images herunter und startet sie im Hintergrund.

4. Zugriff auf BookStack:

   Öffnen Sie Ihren Webbrowser und gehen Sie zu http://your_vps_ip. Sie sollten die BookStack-Einstellungsseite sehen. Befolgen Sie die Anweisungen auf dem Bildschirm, um die Installation abzuschließen.

Verwaltung von BookStack

Sie können BookStack über die Weboberfläche verwalten. Sie können Benutzer hinzufügen, verschiedene Bücher, Kapitel und Seiten entsprechend Ihren Bedürfnissen erstellen.

Häufig gestellte Fragen

F1: Kann ich BookStack ohne Docker ausführen?

Ja, Sie können BookStack ohne Docker installieren, aber das erfordert mehr manuelle Einrichtung, einschließlich der Konfiguration von PHP, MariaDB und einem Webserver wie Apache oder Nginx. Docker vereinfacht den Prozess erheblich, was eine einfachere Bereitstellung und Aktualisierung ermöglicht.

F2: Wie mache ich ein Backup meiner BookStack-Installation?

Um ein Backup Ihrer BookStack-Installation zu erstellen, müssen Sie sowohl die Datenbank als auch die Anwendungsdateien sichern. Sie können dies erreichen, indem Sie Docker-Befehle verwenden, um die Datenbankdateien zu kopieren und die Daten aus Ihrem BookStack-Verzeichnis zu speichern. Die Automatisierung dieses Prozesses über Skripte kann das Backup weiter vereinfachen.

F3: Ist BookStack sicher für das Selbsthosting?

BookStack ist relativ sicher, insbesondere wenn es selbst gehostet wird. Es ist wichtig, starke Passwörter zu verwenden, die Software aktuell zu halten und geeignete Firewall-Regeln zu konfigurieren. Darüber hinaus hilft die Verwendung von SSL (über Let’s Encrypt oder ähnliches), den sicheren Zugriff auf Ihre BookStack-Instanz im Internet zu gewährleisten.

Fazit

Das Selbsthosting von BookStack auf einem VPS bietet eine leistungsstarke Möglichkeit, Ihre Dokumentationsbedürfnisse zu verwalten. Mit den in diesem Leitfaden beschriebenen Schritten können Sie effizient Ihre eigene Instanz von BookStack bereitstellen und verwalten. Vergessen Sie nicht, die verschiedenen Funktionen von BookStack zu erkunden und es an Ihre Anforderungen anzupassen, während Sie Ihre Wissensdatenbank erweitern. Für andere Optionen und Vergleiche von VPS-Anbietern schauen Sie sich unseren vollständigen VPS-Vergleich an. Viel Spaß beim Hosting!