====== DokuWiki auf Debian, Ubuntu und abgeleiteten Distributionen ======


Ein Debian-Paket für DokuWiki existiert im offiziellen Debian-Repository und kann mit den üblichen Debian-Werkzeugen installiert werden.

Wir raten jedoch generell davon ab, DokuWiki als Debian-Paket zu installieren, und zwar aus mehreren Gründen:

  * Das Paket ist veraltet und verwendet eine ältere Version von DokuWiki, was es mit vielen neueren Plugins inkompatibel macht
  * Das Paket verwendet eine andere Verzeichnisstruktur, was zu Problemen mit einigen Plugins führen kann und einige allgemeine Dokumentationen unbrauchbar macht
  * Das Paket ersetzt einige der internen Bibliotheken von DokuWiki durch Debian-Paketversionen, was wiederum zu Inkompatibilitäten führen kann


===== DokuWiki Debian-Paket =====

Details zum offiziellen Paket finden Sie in diesen Quellen:

  * [[https://packages.debian.org/dokuwiki|Dokuwiki-Paket-Übersicht]]
  * [[https://packages.qa.debian.org/dokuwiki|Technische Übersicht und Nachrichten]]
  * [[https://bugs.debian.org/dokuwiki|Fehlerberichte]]

Zusätzliche Details können auf der [[https://wiki.debian.org/DokuWiki|DokuWiki-Seite im Debian-Wiki]] gefunden werden.


===== Empfohlene Einrichtung =====

Anstatt sich auf das Debian-Paket zu verlassen, wird empfohlen, einfach den Webserver und PHP über den Paketmanager zu installieren und DokuWiki aus den Quellen zu installieren.

Für eine einfache Apache mod_php-Installation kann dies wie folgt aussehen:

  - Bereiten Sie das System vor, laden Sie die neueste DokuWiki-Version herunter und entpacken Sie sie:<code bash>
$> sudo apt update
$> sudo apt install php libapache2-mod-php php-xml php-mbstring php-zip php-intl php-gd
$> sudo systemctl restart apache2.service
$> wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
$> tar xzvf dokuwiki-stable.tgz
$> sudo mv dokuwiki-*a /var/www/html/dokuwiki
$> sudo chown -R www-data:www-data /var/www/html/dokuwiki
</code>

  - **Optional**\\ Wenn Sie eine Firewall verwenden, lassen Sie den HTTP-Verkehr zu. Für die Uncomplicated Firewall (ufw) lautet der Befehl wie folgt:<code bash>
sudo ufw allow 'WWW Full'
</code>

  - Rufen Sie Ihren Webbrowser unter %%http://localhost/dokuwiki/install.php%% auf, um Ihre neue DokuWiki-Installation zu konfigurieren.