# So konfigurieren Sie den Apache für die Verwendung eigener Fehlerseiten

Das Erstellen eigener Apache-Fehlerseiten ermöglicht es Ihnen unter anderem, ihr Design und Branding auf Ihrer gesamten Webseite sichtbar zu machen. Wir zeigen Ihnen, wie das gelingt.

## Warum sollte man eine eigene Fehlerseite haben?

Keiner möchte, dass bei seinem Webserver [HTTP](https://www.ionos.at/digitalguide/hosting/hosting-technik/was-ist-http/)-Fehler auftreten. Doch je nach Serverauslastung, Internetverbindung oder Benutzereingabe kann dies ab und zu passieren. Der [Apache-Webserver](https://www.ionos.at/digitalguide/server/konfiguration/apache-webserver-einrichten-so-wirds-gemacht/) bietet einen Standardsatz von generischen Fehlerseiten für [Error 404](https://www.ionos.at/digitalguide/websites/webseiten-erstellen/was-bedeutet-der-error-404-not-found/), [HTTP-Error 500](https://www.ionos.at/digitalguide/hosting/hosting-technik/http-error-500-tipps-tricks-zur-problemloesung/) und andere häufige Fehler.

Das Erstellen benutzerdefinierter Fehlerseiten ermöglicht es Ihnen jedoch:

- Ihr Branding auf diesen Seiten fortzusetzen
- Ihr Design in das Look and Feel Ihrer Website zu integrieren
- Verloren gegangene Besuchende an ihren Bestimmungsort weiterzuleiten
- Fehlerseiten in anderen Sprachen als Englisch bereitzustellen

## Anforderungen

- Cloud Server unter Linux ([CentOS](https://www.ionos.at/digitalguide/server/knowhow/was-ist-centos-versionen-systemvoraussetzungen/) Stream 9 oder [Ubuntu](https://www.ionos.at/digitalguide/server/knowhow/ubuntu-das-linux-system-fuer-jedermann/) 24.04)
- [Apache](https://www.ionos.at/digitalguide/server/knowhow/was-ist-apache/) ist installiert und wird ausgeführt

Tipp Apache und Ubuntu gehören zu den beliebtesten Open-Source-Plattformen, um einen Webserver zu hosten. Wir zeigen Ihnen, wie Sie [Apache unter Ubuntu installieren](https://www.ionos.at/digitalguide/server/konfiguration/apache-unter-ubuntu-installieren/) können.

## Eigene Apache-Fehlerseite erstellen

Zuerst müssen Sie die benutzerdefinierte Fehlerseite erstellen. Zu Testzwecken werden wir eine Beispiel-Fehlerseite erstellen, um 404-Fehler zu abzufangen.

Verwenden Sie [SSH](https://www.ionos.at/digitalguide/server/tools/secure-shell-ssh/), um sich mit Ihrem Server zu verbinden, und gehen Sie zum Hauptverzeichnis Ihrer Website (oft `/var/www/html/`). Erstellen Sie mit folgendem Befehl eine neue Seite namens **my-404.html**:

```bash
sudo nano my-404.html
```

Fügen Sie das Folgende in diese Datei ein:

```none
<html>
<head>
<title>My Custom 404 Error Page</title>
</head>
<body>
<p>Whoops, page not found! Sorry about that.</p>
<div class="hash d-none" hidden>hash_ffdd53ea515b1085a4b021e8498a21865a363d0f</div><script data-shy-copy-guard>(function(){var C=[0x00AD,0x200B,0x200C,0x200D,0x2060,0xFEFF];var s=function(t){for(var i=0;i<C.length;i++){t=t.split(String.fromCharCode(C[i])).join("");}return t;};document.addEventListener("copy",function(e){var sel=document.getSelection();if(!sel||sel.isCollapsed||!e.clipboardData){return;}e.clipboardData.setData("text/plain",s(sel.toString()));try{var d=document.createElement("div");d.appendChild(sel.getRangeAt(0).cloneContents());e.clipboardData.setData("text/html",s(d.innerHTML));}catch(x){}e.preventDefault();});})();</script></body>
</html>
```

Speichern Sie die Datei und verlassen Sie Nano mit den Tastenkombinationen **\[Strg\] + \[O\]** und **\[Strg\] + \[X\]**. Sie können die Datei nun ansehen, indem Sie auf “http://example.com/my-404.html” gehen, um sicherzustellen, dass sie korrekt angezeigt wird.

## Eigene Apache-Fehlerseite konfigurieren

Nun müssen Sie Ihren Apache-Webserver so konfigurieren, dass er die eben erstellte Fehlerseite auch verwendet. Zu diesem Zweck fügen Sie eine **ErrorDocument-Anweisung** hinzu. Die Syntax für diese Direktive lautet:

```none
ErrorDocument 404 [path to file]
```

Wollen Sie diese Fehlerseite global verwenden, sollte die Direktive in der Hauptkonfigurationsdatei von Apache stehen. Soll die Seite stattdessen nur für einen **virtuellen Host** verwendet werden (z. B. wenn Sie die Ihre Website in mehreren Sprachen anbieten), muss sie in einem **`VirtualHost`-Befehlsblock** stehen. In diesem Abschnitt beschäftigen wir uns hauptsächlich mit der globalen Konfiguration.

Die Apache-Hauptkonfigurationsdatei befindet sich konventionell an folgenden Speicherorten:

- **CentOS Stream 9** /etc/httpd/conf/httpd.conf
- **Ubuntu 24.04** /etc/apache2/apache2.conf

Hinweis Der Speicherort und der Dateiname der Apache-Konfigurationsdatei einer Website kann je nachdem, wie Sie oder Ihr Serveradministrator das Hosting eingerichtet haben, variieren.

Bearbeiten Sie diese Datei mit einem Editor Ihrer Wahl, z.B. mit dem Befehl:

- **CentOS Stream 9** sudo nano /etc/httpd/conf/httpd.conf
- **Ubuntu 24.04** sudo nano /etc/apache2/apache2.conf

Fügen Sie das ErrorDocument an einer passenden Stelle ein. Zum Beispiel:

```none
ErrorDocument 404 /my-404.html
```

Wollen Sie das nur für einen virtuellen Host machen, müssen Sie in der entsprechenden Konfigurationsdatei scrollen, bis Sie den `VirtualHost`-Befehlsblock finden. Stellen Sie sicher, dass die Direktive außerhalb von Directory-Befehlsblöcken platziert wird. Zum Beispiel:

```none
<VirtualHost *:80>
ServerName example.com
ErrorDocument 404 /my-404.html
    <Directory "/var/www/example.com/html">
    AllowOverride All
    </Directory>
</VirtualHost>
```

Speichern und beenden Sie die Datei, und starten Sie dann Apache neu, damit die Änderungen wirksam werden:

- **CentOS Stream 9** sudo systemctl restart httpd
- **Ubuntu 24.04** sudo systemctl restart apache2

Testen Sie schließlich Ihr Fehlerdokument, indem Sie zu einer ungültigen URL für Ihre Website gehen. Sie werden stattdessen zu Ihrer neuen benutzerdefinierten 404-Seite weitergeleitet.

## Andere HTTP-Fehlercodes

Der häufigste benutzerdefinierte Fehler ist der Fehler 404. Sie können jedoch auch eigene Fehlermeldungen für andere HTTP-Fehlermeldungen erstellen. Bei Apache können eigene Fehlerseiten für alle 4xx- und 5xx-Fehlercodes konfiguriert werden. Eine [Übersicht der wichtigsten HTTP-Status-Codes](https://www.ionos.at/digitalguide/hosting/hosting-technik/die-wichtigsten-http-status-codes-im-ueberblick/) finden Sie in unserem weiterführenden Artikel. Eine vollständige Liste der Fehlercodes finden Sie auf [Wikipedia](https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#4xx_Client_Error).


This is a markdown version of: [https://www.ionos.at/digitalguide/server/konfiguration/apache-fuer-die-verwendung-benutzerdefinierter-fehlerseiten-konfigurieren/](https://www.ionos.at/digitalguide/server/konfiguration/apache-fuer-die-verwendung-benutzerdefinierter-fehlerseiten-konfigurieren/) for AI/LLM consumption.