Wie setze ich die DocumentRoot in der Apache2-Konfiguration korrekt?

1. Verzeichnis auswählen und vorbereiten
2. Ändern der DocumentRoot in der Apache-Konfiguration
3. Zusätzliche Anpassungen und Rechte
4. Apache-Konfiguration testen und neu starten
5. Zusammenfassung

Die DocumentRoot-Direktive in der Apache2-Webserver-Konfiguration gibt das Verzeichnis an, aus dem der Server die Dateien ausliefert, wenn eine Clientanfrage an die Webadresse gestellt wird. Das heißt, die DocumentRoot definiert den Basisordner, in dem sich Ihre Webseite befindet.

Verzeichnis auswählen und vorbereiten

Bevor Sie die DocumentRoot festlegen, sollten Sie sicherstellen, dass das Verzeichnis, das Sie als Dokumentwurzel verwenden möchten, tatsächlich existiert und die richtigen Zugriffsrechte besitzt. Üblicherweise befinden sich Webseiteninhalte in Verzeichnissen wie /var/www/html oder einem eigenen Verzeichnis wie /var/www/meine-webseite. Wichtig ist, dass der Benutzer, unter dem der Apache läuft (oft www-data), auf dieses Verzeichnis lesend zugreifen kann.

Ändern der DocumentRoot in der Apache-Konfiguration

Die Konfiguration des Apache-Webservers ist je nach Betriebssystem und spezifischer Einrichtung in unterschiedlichen Dateien organisiert. Üblicherweise befindet sich die Hauptkonfiguration oder die virtuelle Host-Konfiguration in Dateien unter /etc/apache2/sites-available/. Für eine Standard-Webseite findet sich eine Datei wie 000-default.conf.

Öffnen Sie die entsprechende Konfigurationsdatei mit einem Texteditor Ihrer Wahl, zum Beispiel:

sudo nano /etc/apache2/sites-available/000-default.conf

Innerhalb dieser Datei sehen Sie die Zeile mit DocumentRoot, zum Beispiel:

DocumentRoot /var/www/html

Ändern Sie diesen Pfad auf das gewünschte Verzeichnis, zum Beispiel:

DocumentRoot /var/www/meine-webseite

Zusätzliche Anpassungen und Rechte

Nach der Änderung der DocumentRoot ist es wichtig, dass Sie auch den Zugriff auf das Verzeichnis in der Apache-Konfiguration erlauben. Das erfolgt über <Directory>-Blöcke, die meist ebenfalls in der gleichen Konfigurationsdatei stehen. Sie sollten sicherstellen, dass ein Eintrag wie der folgende vorhanden ist:

<Directory /var/www/meine-webseite> Options Indexes FollowSymLinks AllowOverride None Require all granted</Directory>

Dieser Abschnitt stellt sicher, dass Apache auf das Verzeichnis zugreifen darf und die darin liegenden Dateien ausliefert.

Apache-Konfiguration testen und neu starten

Nachdem Sie die Änderungen gemacht haben, sollten Sie die Syntax der Apache-Konfiguration prüfen, um Fehler zu vermeiden. Das machen Sie mit dem Befehl:

sudo apache2ctl configtest

Wenn hier keine Fehler angezeigt werden, starten Sie den Apache-Webserver neu, damit die Änderungen wirksam werden:

sudo systemctl restart apache2

Ab diesem Zeitpunkt liefert Apache beim Aufruf Ihrer Webseite die Dateien aus dem neuen DocumentRoot-Verzeichnis aus.

Zusammenfassung

Das korrekte Setzen der DocumentRoot besteht also darin, das gewünschte Verzeichnis in der jeweiligen Virtual-Host-Konfiguration zu definieren, passende Zugriffsrechte zu vergeben und Apache nach Prüfung der Konfiguration neu zu starten. So stellen Sie sicher, dass Ihre Webseite aus dem richtigen Ordner ausgeliefert wird.