HowtoForge

BookStack Installation auf Ubuntu 18.04 LTS

von ·

BookStack ist eine kostenlose und Open-Source-Wissensmanagement-Plattform, mit der Sie Dokumentation und Wikis-Inhalte für Ihre Benutzer erstellen können. BookStack ist in der Sprache PHP geschrieben und verwendet das Laravel Web-Framework. Mit BookStack können Sie BookStack nach Ihren Wünschen einrichten, z.B. Namen, Logo und Registrierungsoptionen ändern. BookStack bietet viele Funktionen wie Mehrsprachenunterstützung, Markdown Editor, Anpassbar, Durchsuchbar, WYSIWYG-Schnittstelle, Rollen- und Berechtigungsmanagement, Integrierte Authentifizierung und vieles mehr.

In diesem Tutorial erfahren wir, wie man Bookstack mit Apache in Ubuntu 18.04 Server installiert.

Anforderungen

  • Ein Server mit Ubuntu 18.04.
  • Ein Nicht-Root-Benutzer mit sudo-Rechten.

Erste Schritte

Vor dem Start müssen Sie Ihr System auf die neueste Version aktualisieren. Sie können dies tun, indem Sie den folgenden Befehl ausführen:

sudo apt-get update -y
sudo apt-get upgrade -y

Sobald Ihr System aktualisiert ist, starten Sie das System neu, um die Änderungen zu übernehmen.

LAMP-Server installieren

Zuerst müssen Sie den Apache Webserver, MariaDB Server, PHP und andere PHP-Module auf Ihrem System installieren. Du kannst sie alle installieren, indem du den folgenden Befehl ausführst:

sudo apt-get install apache2 mariadb-server php7.2 libapache2-mod-php7.2 php7.2-common php7.2-sqlite3 php7.2-curl php7.2-intl php7.2-mbstring php7.2-xmlrpc php7.2-mysql php7.2-gd php7.2-xml php7.2-cli php7.2-tidy php7.2-zip unzip wget git -y

Sobald alle Pakete installiert sind, öffnen Sie die Datei php.ini und nehmen Sie einige Änderungen vor:

sudo nano /etc/php/7.2/apache2/php.ini

Nehmen Sie die folgenden Änderungen vor:

memory_limit = 256M
upload_max_filesize = 150M
max_execution_time = 360
date.timezone = Asia/Kolakata

Speichern und schließen Sie die Datei.

MariaDB konfigurieren

Standardmäßig ist MariaDB nicht gesichert. Daher müssen Sie es zuerst sichern. Sie können es sichern, indem Sie den folgenden Befehl ausführen:

sudo mysql_secure_installation

Beantworten Sie alle Fragen wie unten beschrieben:

    Enter current password for root (enter for none): ENTER
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

Sobald die MariaDB gesichert ist, melden Sie sich bei der MariaDB-Shell an:

mysql -u root -p

Gib dein Root-Passwort ein. Erstellen Sie dann eine Datenbank und einen Benutzer für Bookstack:

MariaDB [(none)]> CREATE DATABASE bookstackdb;
MariaDB [(none)]> CREATE USER 'bookstack'@'localhost' IDENTIFIED BY 'password';

Ersetzen Sie das Wort „Passwort“ im obigen Befehl durch ein sicheres Passwort und nicht durch ein heruntergeklapptes. Als nächstes erteilen Sie dem Bookstack mit dem folgenden Befehl alle Berechtigungen:

MariaDB [(none)]> GRANT ALL ON bookstackdb.* TO 'bookstack'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION;

Ersetzen Sie hier das Wort „Passwort“ wieder durch das gleiche Passwort, das Sie oben verwendet haben. Als nächstes leeren Sie die Privilegien und verlassen Sie die MariaDB-Shell:

MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

Bookstack installieren

Zuerst müssen Sie Composer auf Ihrem System installieren. Composer ist ein Abhängigkeitsmanager für PHP. Sie können Composer mit dem folgenden Befehl installieren:

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Als nächstes ändern Sie das Verzeichnis auf /var/wwww/html und laden Sie die neueste Version von Bookstack aus dem Git-Repository mit dem folgenden Befehl herunter:

cd /var/www/html/
sudo git clone https://github.com/BookStackApp/BookStack.git --branch release --single-branch

Als nächstes wechseln Sie das Verzeichnis auf den Bookstack und installieren alle von PHP benötigten Abhängigkeiten mit dem folgenden Befehl:

cd Bookstack
sudo composer install

Sobald alle Abhängigkeiten installiert sind, kopieren Sie die Konfigurationsdatei der Beispielumgebung mit dem folgenden Befehl:

sudo cp .env.example .env

Aktualisieren Sie anschließend die Datenbankeinstellungen in der .env-Datei:

sudo nano .env

Nehmen Sie die folgenden Änderungen vor:

# Database details
DB_HOST=localhost
DB_DATABASE=bookstackdb
DB_USERNAME=bookstack
DB_PASSWORD=password

Speichern und schließen Sie die Datei. Erstellen Sie dann den Anwendungsschlüssel und migrieren Sie die Datenbank mit dem folgenden Befehl:

sudo php artisan key:generate

Output:

**************************************
*     Application In Production!     *
**************************************

 Do you really wish to run this command? (yes/no) [no]:
 > yes

Application key [base64:KTcNpGD5CacIz20eiKpusk02YaHm14OQTZTERizEDBw=] set successfully.

Als nächstes müssen Sie die Datenbank migrieren. Sie können die Datenbank mit dem folgenden Befehl migrieren:

sudo php artisan migrate

Sie sollten die folgende Ausgabe sehen:

**************************************
*     Application In Production!     *
**************************************

 Do you really wish to run this command? (yes/no) [no]:
 > yes

Migration table created successfully.

Als nächstes geben Sie dem Bookstack-Verzeichnis mit dem folgenden Befehl die entsprechenden Berechtigungen:

sudo chown -R www-data:www-data /var/www/html/BookStack/
sudo chmod -R 755 /var/www/html/BookStack/

Apache für Bookstack konfigurieren

Als nächstes müssen Sie eine virtuelle Apache-Hostdatei für Bookstack erstellen. Du kannst es mit dem folgenden Befehl erstellen:

sudo nano /etc/apache2/sites-available/bookstack.conf

Füge die folgenden Zeilen hinzu:

<VirtualHost *:80>
     ServerAdmin admin@example.com
     DocumentRoot /var/www/html/Bookstack
     ServerName example.com
     ServerAlias www.example.com

    <Directory /var/www/html/Bookstack/>
        Options FollowSymlinks
        AllowOverride All
        Require all granted
     </Directory>

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Ersetzen Sie ‚example.com‘ und ‚www.example.com‘ in der obigen Datei durch Ihren eigenen Domainnamen, speichern und schließen Sie dann die Datei und aktivieren Sie die virtuelle Apache-Hostdatei und das Umschreibmodul mit den folgenden Befehlen:

sudo a2ensite bookstack.conf
sudo a2enmod rewrite

Starten Sie schließlich den Apache-Webdienst neu, um alle Änderungen zu übernehmen:

sudo systemctl restart apache2

Zugriff auf den Bookstack

Öffnen Sie Ihren Webbrowser und geben Sie die URL ein, in meinem Fall http://example.com, Sie werden auf die folgende Seite weitergeleitet:

Bookstack Login-Seite

Geben Sie nun den Standardbenutzernamen als admin@admin.com und das Passwort als Passwort ein und klicken Sie dann auf die Schaltfläche LOG IN. Auf der folgenden Seite werden Sie zum Bookstack Dashboard weitergeleitet:

Melden Sie sich mit Standardbenutzername und Passwort an.

Der nächste Schritt sollte darin bestehen, das Standardkennwort zu ändern, um das BookStack-Login zu sichern.

Fazit

Herzlichen Glückwunsch! Sie haben Bookstack erfolgreich in Ubuntu 18.04 LTS Server installiert. Sie können nun ganz einfach Ihre eigene Wiki-Seite mit Bookstack erstellen. Zögern Sie nicht, mich zu fragen, wenn Sie Fragen haben.

Das könnte dich auch interessieren …