====== DokuWiki unter Ubuntu installieren ======

Das ist eine Anweisung, wie ein einzelnes DokuWiki unter Ubuntu 14.04 installiert wird. Die Installation anderer Versionen wird weiter unten diskutiert. Für das Installieren einer DokuWiki Farm, diesen Anweisungen folgen und danach die [[:farms|Farm Page]] (en) aufsuchen.

Bitte beachten, dass ein DokuWiki-Paket über die Ubuntu Anwendungsverwaltung erhältlich ist. Soll das genutzt werden, bitte stattdessen die [[install:debian|Debian install page]] (en) verwenden. Dieser Artikel hier beschreibt die Installation von DokuWiki aus einem TAR-Archiv (//tarball//). (Die Pakete von Ubuntu und Debian folgen den Debian Verzeichnis-Gepflogenheiten und erfordern daher unterschiedliche Schritte wenn sie genutzt werden sollen.)

:!: **Für Ubuntu 16.04** bitte libapache2-mod-php7.0 verwenden und die Installation von php7.0-xml sowie php7.0 mit ''apt-get'' sicherstellen.

Für den Upgrade von Ubuntu 14.04 LTS nach Ubuntu 16.04 LTS sind folgende Schritte erforderlich:

  * apt-get install php7.0
  * apt-get install php-mbstring
  * apt-get install php7.0-xml

Das löst das Problem, DokuWiki vor den Upgrades auf den Normalzustand rücksetzen zu müssen.

  - Installieren von Ubuntu Server 14.04 [[http://askubuntu.com/questions/340965/how-do-i-install-ubuntu-server-step-by-step|Step by step instructions with screenshots]] (en)
  - Aktualisieren (//update//) & Hochrüsten (//upgrade//) von Ubuntu.<code bash>sudo apt-get update && sudo apt-get upgrade</code>
  - Installieren von Apache2 und PHP.<code bash>sudo apt-get install apache2 libapache2-mod-php php-xml</code>
  - Freischalten des Apache Rewrite Moduls.<code bash>sudo a2enmod rewrite</code>
  - Herunterladen und Entpacken der neuesten stabilen Version.<code bash>
cd /var/www
sudo wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
sudo tar xvf dokuwiki-stable.tgz
sudo mv dokuwiki-*/ dokuwiki
</code>
  - Ändern der Benutzerrechte.<code bash>sudo chown -R www-data:www-data /var/www/dokuwiki</code>
  - Ändern des Dokumenten-Hauptverzeichnisses in Apache zu ''/var/www/dokuwiki''<code bash>sudo nano /etc/apache2/sites-enabled/000*.conf</code> Mit dem Editor\\ ''DocumentRoot /var/www/html''\\ durch\\ ''DocumentRoot /var/www/dokuwiki''\\ ersetzen.
     - Soll ein DokuWiki-Server für Testzwecke auf //localhost// laufen, dann **nicht** den Inhalt von \\ ''/etc/apache2/sites-enabled/000*.conf''  ändern. Stattdessen in \\ ''/etc/apache2/sites-available''\\ mit <code bash>sudo touch apache2-dokuwiki.conf</code> eine neue Datei mit folgendem Inhalt erzeugen:<code bash><VirtualHost 127.0.0.1>
        DocumentRoot /var/www/dokuwiki
 	ServerName localhost
</VirtualHost></code> 
     - Das neue Projekt in die aktivierten Seiten in ''/etc/apache2/sites-enabled'' mit<code bash>sudo a2ensite apache2-dokuwiki</code> freischalten
     - und dann den Apache2-Service mit <code bash>sudo service apache2 reload</code>neu starten.
  - Mit dem Editor die Sicherheitseinstellung ''AllowOverride'' in Apache2 zur Benutzung der ''.htaccess'' Dateien ändern:<code bash>sudo nano /etc/apache2/apache2.conf</code>
     - Im Verzeichnis ''/var/www/'' den Ausdruck\\ ''AllowOverride None''\\ durch\\ ''AllowOverride All''\\ ersetzen.
  - Neustart des Apache2 Service.<code bash>sudo service apache2 restart</code>
  - Im Browser ''http://IP-Addresse-eigener-Server/install.php'' zur Erstkonfiguration des DokuWiki aufrufen.
     - Für den Testbetrieb auf dem eigenen Rechner (//localhost//) gemäß der Punkte 7a-c, muss ''127.0.0.1/install.php'' oder auch ''localhost/install.php'' aufgerufen werden.
  - Nach der Installation die Datei ''install.php'' löschen.<code bash>sudo rm /var/www/dokuwiki/install.php</code>
  - Sollen Mails gesendet werden (z.B. bei der Registrierung von Nutzern) muss ein entsprechendes Programm (  beispielsweise //postfix//) installiert <code bash>sudo apt-get install postfix
</code> und angemessen konfiguriert werden.
  - Viel Spaß mit dem eigenen DokuWiki-Server!


===== Zusätzliche Installations-Informationen =====
Für weitere Informationen über die Installation und Konfiguration von Dokuwiki auf Ubuntu, bitte hier weiter lesen [[install:debian_ubuntu_extras]] (en).

====== Apache Konfiguration für den Betrieb von DokuWiki in ~/public_html ======

Folgendes arbeitet fein mit Ubuntu 11.04:
  - Installieren von //apache2// und dem//php5// Modul:<code bash>sudo apt-get install apache2 libapache2-mod-php5</code>
  - Schalte die Module //userdir// und//rewrite// ein:<code bash>
sudo a2enmod userdir
sudo a2enmod rewrite
</code>
  - Um ''.htaccess'' zu aktivieren, editiere ''/etc/apache2/mods-enabled/userdir.conf'' und ändere die Anweisung ''AllowOverride'' zu ''All''((FIXME: Jemand mit tieferen Apache-Kenntnissen kann eventuell eine "sicherere" Einstellung anstelle von ''AllowOverride'' vorschlagen))
  - Standardmäßig ist php in den Benutzerverzeichnissen deaktiviert. Um es zu aktivieren, die Zeilen gemäß der Anweisung in ''/etc/apache2/mods-enabled/php5.conf'' kommentieren.
  - Neustart //Apache// mit<code bash>sudo service apache2 restart</code>


======Ubuntu Server 14.04 und lighttpd ======

  - Installieren von lighttpd und php. <code bash>
sudo apt-get install lighttpd 
sudo apt-get install php5-cgi 
</code>
  - DokuWiki herunterladen und im Verzeichnis ''www'' ablegen. Den Dateinamen entsprechend der heruntergeladenen Datei und dem Ablageort umbenennen. <code bash>
tar xvfz dokuwiki.tgz 
ls -l
sudo cp -r dokuwiki/ /var/www/
sudo chown -R www-data:www-data /var/www/dokuwiki
</code>
  - Konfiguration von //lighttpd// für php.<code bash>
sudo lighttpd-enable-mod fastcgi-php
sudo /etc/init.d/lighttpd force-reload
</code>
  - Das war's. Viel Spaß mit dem eigenen DokuWiki-Server. (Zum Test ob es korrekt arbeitet ''http://localhost/dokuwiki'' aufrufen)