Wie man DokuWiki auf Debian 12 installiert

DokuWiki ist eine einfache, vielseitige Open-Source-Wiki-Software, die keine Datenbank benötigt. Sie ist bekannt für ihre einfache Wartung, Lesbarkeit und Benutzerverwaltung, was sie ideal für die Erstellung und Verwaltung von Dokumentationen in Unternehmens- oder kollaborativen Umgebungen macht. Angetrieben von PHP, unterstützt die vielseitige Wiki-Software und die integrierte Zugriffskontrolle (ACL) wichtige Authentifizierungsmechanismen. DokuWiki bietet eine einfache Verwaltung, ist einfach zu installieren, zu warten und von einem Host auf einen anderen zu sichern.

In diesem Leitfaden führen wir Sie durch die Installation von DokuWiki auf dem Debian 12-Server. Sie werden DokuWiki mit dem LAMP-Stack (Apache2, MariaDB und PHP), UFW und SSL/TLS-Zertifikaten über Letsencrypt installieren.

Voraussetzungen

Stellen Sie sicher, dass Sie Folgendes haben, um mit diesem Leitfaden fortzufahren:

Einen Debian 12-Server.
Einen Nicht-Root-Benutzer mit Administratorrechten.
Einen Domainnamen, der auf die IP-Adresse des Servers verweist.

Abhängigkeiten installieren

Standardmäßig ist das DokuWiki-Paket im Debian-Repository verfügbar. Um sicherzustellen, dass Sie die neueste Version von DokuWiki installiert haben, werden Sie DokuWiki manuell auf Ihrem Debian-Server installieren.

In diesem Abschnitt installieren Sie die Abhängigkeiten für DokuWiki, einschließlich der LAMP-Stack-Pakete (Apache2, MariaDB und PHP), UFW und Certbot.

Bevor Sie beginnen, aktualisieren Sie Ihr Debian-Repository mit dem folgenden Befehl.

sudo apt update

Installieren Sie die LAMP-Stack-, UFW- und Certbot-Pakete mit dem folgenden apt install-Befehl. Geben Sie Y ein und drücken Sie ENTER, wenn Sie dazu aufgefordert werden.

sudo apt install apache2 mariadb-server php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd ufw certbot python3-certbot-apache

install deps

Sobald die Installation abgeschlossen ist, überprüfen Sie den Status der Dienste Apache und MariaDB, um sicherzustellen, dass der Dienst läuft.

Führen Sie den folgenden Befehl aus, um den Status des apache2-Dienstes zu überprüfen.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Wenn apache2 läuft, sollten Sie die Ausgabe ‘aktiv (laufend)’ erhalten. Und die Ausgabe ‘aktiviert’ bestätigt, dass apache2 beim Systemstart gestartet wird.

verify apache2

Führen Sie nun den folgenden Befehl aus, um den Status des mariadb-Dienstes zu überprüfen.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Stellen Sie sicher, dass der mariadb-Dienst auf Ihrem Debian-Rechner ‘aktiviert’ und ‘aktiv (laufend)’ ist.

verify mariadb

UFW konfigurieren

In diesem Leitfaden sichern Sie Ihren Debian-Server mit UFW (Uncomplicated Firewall). In diesem Fall müssen Sie den SSH-Port für den Remote-Zugriff und die Ports für die HTTP- und HTTPS-Protokolle öffnen, um die DokuWiki-Installation auszuführen.

Führen Sie den folgenden Befehl aus, um die OpenSSH- und ‘WWW Full‘-Profile zu UFW hinzuzufügen.

Das OpenSSH-Profil öffnet den Standard-SSH-Port 22, während das ‘WWW Full’-Profil sowohl die HTTP- als auch die HTTPS-Ports öffnet.

sudo ufw allow OpenSSH  
sudo ufw allow 'WWW Full'

Führen Sie nun den folgenden Befehl aus, um UFW auf Ihrem Debian-Rechner zu starten und zu aktivieren.

sudo ufw enable

Geben Sie y ein, wenn Sie zur Bestätigung aufgefordert werden, und Sie sollten eine Ausgabe wie ‘Firewall ist aktiv und beim Systemstart aktiviert‘ erhalten. Die UFW wird beim Systemstart automatisch ausgeführt.

setup ufw

Führen Sie zuletzt den folgenden Befehl aus, um den UFW-Status zu überprüfen. Stellen Sie sicher, dass sowohl die OpenSSH- als auch die ‘WWW Full’-Profile in Ihren UFW-aktivierten Regeln aufgeführt sind.

sudo ufw status

verify ufw

php.ini konfigurieren

Im folgenden Abschnitt konfigurieren Sie PHP, indem Sie die Standard-php.ini-Datei ändern und einige der Konfigurationen für die DokuWiki-Installation anpassen.

Führen Sie den folgenden Befehl im Nano-Editor aus, um die PHP-Konfigurationsdatei ‘/etc/php/8.2/apache2/php.ini‘ zu öffnen.

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

Ändern Sie die Standardkonfiguration wie folgt. Stellen Sie sicher, dass Sie den memory_limit-Parameter mit Ihrem aktuellen Server-RAM anpassen.

memory_limit=256M  
upload_max_filesize=32M  
post_max_size=32M  
max_execution_time=60

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Führen Sie nun den folgenden systemctl-Befehl aus, um den apache2-Dienst neu zu starten und die Auswirkungen Ihrer Änderungen zu übernehmen.

sudo systemctl restart apache2

MariaDB-Server konfigurieren

Nachdem Sie PHP konfiguriert haben, besteht der nächste Schritt darin, Ihre MariaDB-Serverinstallation zu konfigurieren, dann eine neue Datenbank und einen Benutzer zu erstellen, die DokuWiki verwenden werden.

Starten Sie den Konfigurationsprozess von MariaDB, indem Sie den Befehl mariadb-secure-installation unten ausführen.

sudo mariadb-secure-installation

Geben Sie Y ein, wenn Sie aufgefordert werden, die neue Konfiguration auf MariaDB anzuwenden, oder Sie können auch n für Nein eingeben, um sie abzulehnen. Im Folgenden sind einige der MariaDB-Konfigurationen aufgeführt, nach denen Sie gefragt werden:

Die Standardinstallation von MariaDB kommt ohne Passwort, drücken Sie ENTER, wenn Sie nach dem Passwort gefragt werden.
Geben Sie nun Y ein, um das MariaDB-Root-Passwort festzulegen. Geben Sie dann das neue Passwort für MariaDB ein und wiederholen Sie das Passwort.
Geben Sie Y ein, um den anonymen Benutzer aus Ihrer MariaDB-Installation zu entfernen.
Geben Sie erneut Y ein, wenn Sie aufgefordert werden, die Remote-Anmeldung für den MariaDB-Root-Benutzer zu deaktivieren.
Geben Sie Y ein, um die Standarddatenbank test aus Ihrer MariaDB zu entfernen.
Geben Sie schließlich Y ein, um die Tabellenberechtigungen neu zu laden und die neuen Änderungen anzuwenden.

Nachdem die MariaDB-Konfiguration abgeschlossen ist, müssen Sie eine neue Datenbank und einen Benutzer erstellen, die von DokuWiki verwendet werden.

Melden Sie sich beim MariaDB-Server an, indem Sie den folgenden mariadb-Befehl ausführen. Geben Sie Ihr MariaDB-Root-Passwort ein, wenn Sie dazu aufgefordert werden.

sudo mariadb -u root -p

Führen Sie nun die folgenden Abfragen aus, um eine neue Datenbank dokuwikidb, Benutzer dokuwiki mit dem Passwort ‘p4ssword‘ zu erstellen. Stellen Sie sicher, dass Sie das Passwort mit Ihrem neuen Passwort ändern.

CREATE DATABASE dokuwikidb;  
CREATE USER dokuwiki@localhost IDENTIFIED BY 'p4ssword';  
GRANT ALL PRIVILEGES ON dokuwikidb.* TO dokuwiki@localhost;  
FLUSH PRIVILEGES;

create database user

Überprüfen Sie als Nächstes den Benutzer dokuwiki, um sicherzustellen, dass die Berechtigungen für die Datenbank dokuwikidb vorhanden sind.

SHOW GRANTS FOR dokuwiki@localhost;

In der folgenden Ausgabe haben Sie den Benutzer dokuwiki mit vollen Berechtigungen für die Datenbank dokuwikidb konfiguriert.

show dtabase user

Geben Sie schließlich quit ein, um den MariaDB-Server zu verlassen und mit dem nächsten Schritt fortzufahren.

DokuWiki-Quellcode herunterladen

In diesem Abschnitt werden Sie den DokuWiki-Quellcode herunterladen und das Installationsverzeichnis mit den richtigen Berechtigungen einrichten.

Wechseln Sie in das Verzeichnis /var/www/ und laden Sie die neueste stabile Version von DokuWiki mit dem folgenden wget-Befehl herunter.

cd /var/www/  
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz

Extrahieren Sie nun die Datei dokuwiki-stable.tgz und benennen Sie das extrahierte Verzeichnis in dokuwiki um. Das bedeutet, dass Ihr DokuWiki-Installationsverzeichnis unter /var/www/dokuwiki verfügbar sein wird.

tar xzvf dokuwiki-stable.tgz  
sudo mv dokuwiki-*a dokuwiki

Führen Sie schließlich den folgenden Befehl aus, um den Besitz des Verzeichnisses /var/www/dokuwiki auf den Benutzer www-data und die Gruppe www-data zu ändern. Auf diese Weise kann Ihr Apache2-Webserver den DokuWiki-Quellcode lesen.

sudo chown -R www-data:www-data /var/www/dokuwiki

Apache2-Virtualhost konfigurieren

Nachdem Sie DokuWiki heruntergeladen haben, erstellen Sie nun eine neue Apache2-Virtualhost-Datei, um DokuWiki auszuführen. Stellen Sie sicher, dass Ihr Domainname bereit ist, bevor Sie beginnen. In diesem Beispiel verwenden wir die Domain wiki.howtoforge.local.

Führen Sie nun den Nano-Editor-Befehl aus, um eine neue Apache2-Virtualhost-Konfiguration /etc/apache2/sites-available/dokuwiki.conf zu erstellen.

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

Fügen Sie die folgende Konfiguration ein und stellen Sie sicher, dass Sie den Domainnamen wiki.howtoforge.local durch Ihre Domain ersetzen.

  
    ServerName    wiki.howtoforge.local        
    DocumentRoot  /var/www/dokuwiki  
  
      
          
            AllowOverride All  
            Require all denied  
          
          
            Order allow,deny  
            Deny from all  
          
      
  
    ErrorLog   /var/log/apache2/wiki.howtoforge.local_error.log  
    CustomLog  /var/log/apache2/wiki.howtoforge.local_access.log combined

Wenn Sie fertig sind, speichern Sie die Datei und schließen Sie sie.

Führen Sie als Nächstes den folgenden Befehl aus, um den dokuwiki.conf-Virtualhost zu aktivieren und Ihre Apache-Syntax zu überprüfen, um sicherzustellen, dass keine Fehler vorliegen.

sudo a2ensite dokuwiki.conf  
sudo apachectl configtest

Wenn Sie die richtige Syntax haben und keine Fehler vorliegen, sehen Sie eine Ausgabe ‘Syntax OK‘.

setup apache2

Führen Sie schließlich den folgenden Befehl aus, um den Apache2-Server neu zu starten und Ihre Änderungen anzuwenden.

sudo systemctl restart apache2

DokuWiki mit SSL/TLS-Zertifikaten sichern

An diesem Punkt läuft Ihr DokuWiki und ist zugänglich. Um sicherzustellen, dass Ihre Installation sicher ist, richten Sie SSL/TLS-Zertifikate über Letsencrypt ein.

Führen Sie den Certbot-Befehl unten aus, um SSL/TLS-Zertifikate für Ihren DokuWiki-Domainnamen zu generieren. Stellen Sie sicher, dass Sie die E-Mail-Adresse und den Domainnamen mit Ihren Informationen ändern.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d wiki.howtoforge.local

Sobald der Prozess abgeschlossen ist, sollte Ihre DokuWiki-Installation automatisch mit HTTPS konfiguriert sein. Und Ihre SSL/TLS-Zertifikate sollten im Verzeichnis /etc/letsencrypt/live/yourdomain.com verfügbar sein.

DokuWiki über den Web-Installer installieren

Öffnen Sie Ihren Webbrowser und besuchen Sie Ihren Domainnamen für die DokuWiki-Installation, z. B. https:/wiki.howtoforge.local/install.php. Sie sollten den DokuWiki-Web-Installer sehen.

Wählen Sie die Option ACL aktivieren, geben Sie Ihren Admin-Benutzer, Ihre E-Mail und Ihr Passwort für DokuWiki ein und klicken Sie dann auf Speichern.

install dokuwiki

Sobald die Installation erfolgreich ist, sollten Sie eine Ausgabe ‘Die Konfiguration wurde erfolgreich abgeschlossen.‘ erhalten.

installation finished

Jetzt kehren Sie zu Ihrem Terminal zurück und löschen das install.php-Skript mit dem folgenden Befehl.

sudo rm /var/www/dokuwiki/install.php

Klicken Sie als Nächstes auf den Link ‘Ihr neues DokuWiki‘, um fortzufahren. Und Sie sollten die DokuWiki-Startseite wie folgt erhalten.

dokuwiki homepage

Klicken Sie nun auf die Schaltfläche Anmelden, und Sie sollten die DokuWiki-Anmeldeseite wie folgt erhalten.

Geben Sie Ihren Admin-Benutzer und Ihr Passwort ein und klicken Sie auf Anmelden. Wenn dies erfolgreich ist, sollten Sie mit dem DokuWiki-Dashboard präsentiert werden.

dockuwiki dashboard

Fazit

Herzlichen Glückwunsch! Sie haben nun die Installation von DokuWiki auf dem Debian 12-Server abgeschlossen. Sie haben DokuWiki mit dem LAMP-Stack (Apache2, MariaDB und PHP) installiert. Sie haben auch Ihre DokuWiki-Installation mit UFW (Uncomplicated Firewall) und SSL/TLS-Zertifikaten von Letsencrypt gesichert.