# Grundkonfiguration

Die Grundkonfiguration ist der Ort, an dem du die Basis deiner Site einrichtest — Traffic zu deinem Origin-Server routen, Hostnamen verwalten und Kerneinstellungen konfigurieren, auf denen andere Features aufbauen.

***

### Origin / Load Balancer

Jede Site braucht ein Ziel für den Traffic. In der Grundkonfiguration weist du entweder einen einzelnen **Origin-Server** oder einen **Load Balancer** zu, der Traffic auf mehrere Origins verteilt.

1. Navigiere zu deiner **Site** in smoxy
2. Öffne die **Grundkonfiguration**
3. Wähle deinen Origin oder Load Balancer aus dem Dropdown

Dies bestimmt, wohin smoxy Anfragen standardmäßig sendet. Du kannst dies pro Anfrage mit Conditional Rules überschreiben.

{% hint style="info" %}
**Hinweis:** Origins und Load Balancer werden separat unter **Organisation > Origins & Loadbalancer** erstellt, bevor sie einer Site zugewiesen werden können.
{% endhint %}

***

### Hostnamen

Die Grundkonfiguration zeigt alle Hostnamen (Domains), die mit deiner Site verknüpft sind. Du kannst:

* Neue Hostnamen zur Site **hinzufügen**
* Konfigurationsstatus **anzeigen** (z. B. fehlende CNAME-Einträge)
* Einen Hostnamen zu einer anderen Site **verschieben**
* Einen Hostnamen von der Site **entfernen**
* **DNS- & SSL-Einstellungen** für jeden Hostnamen aufrufen

Wenn du einen Hostnamen hinzufügst, übernimmt er sofort alle Konfigurationseinstellungen der Site.

***

### smoxy aktivieren

Der Schalter **smoxy aktivieren** aktiviert den vollen smoxy-Funktionsumfang (Caching, Optimierung, Sicherheit, Regeln) für diese Site. Wenn deaktiviert, arbeitet smoxy als einfacher Reverse Proxy ohne Optimierung oder Caching.

Dies muss aktiviert sein, bevor Features wie Caching, Bildoptimierung, Acceleration oder Sicherheit verwendet werden können.

***

### Cache-Token

Das Cache-Token wird zur Authentifizierung von Anfragen an die Cache-Invalidierungs-API verwendet. Setze hier ein Token und füge es in deine Purge-Anfragen ein, um Cache-Löschvorgänge zu autorisieren.

***

### Debug-Header

Wenn aktiviert, fügt smoxy Debug-Informationen zu den HTTP-Response-Headern hinzu. Dies ist nützlich zur Fehlerbehebung von Caching-Verhalten, Regelauswertung und Request-Routing.

Aktiviere dies während der Entwicklung oder beim Debugging und deaktiviere es in der Produktion, um keine internen Details preiszugeben.

***

### SSI & ESI

smoxy unterstützt **Server Side Includes (SSI)** und **Edge Side Includes (ESI)** zum Zusammensetzen von Seiten aus mehreren Fragmenten am Edge.

| Feature | Beschreibung                                                            |
| ------- | ----------------------------------------------------------------------- |
| **SSI** | Verarbeitet `<!--#include -->`-Direktiven in HTML-Antworten             |
| **ESI** | Verarbeitet `<esi:include>`-Tags für Edge-seitiges Seitenzusammensetzen |

{% hint style="info" %}
**Hinweis:** ESI kann nur aktiviert werden, wenn SSI ebenfalls aktiviert ist.
{% endhint %}

Diese Features sind nützlich für Sites, die Seiten aus cachebaren Fragmenten mit unterschiedlichen TTLs zusammensetzen (z. B. ein statischer Header der stundenlang gecacht wird und ein dynamisches Warenkorb-Widget das sekündlich gecacht wird).

***

### HTTP-Header

Du kannst benutzerdefinierte HTTP-Header hinzufügen, die smoxy bei jeder Anfrage oder Antwort für diese Site einschließt.

#### Request-Header

Header, die von smoxy an deinen Origin-Server gesendet werden. Nützlich, um zusätzlichen Kontext an dein Backend zu übergeben.

**Format:** Ein Header pro Zeile als `header-name = value`

#### Response-Header

Header, die von smoxy an den Browser des Besuchers gesendet werden. Nützlich für Sicherheits-Header, CORS oder benutzerdefinierte Metadaten.

**Format:** Ein Header pro Zeile als `header-name = value`

Hier konfigurierte Header gelten für alle Anfragen auf dieser Site. Um Header bedingt zu setzen (z. B. nur für bestimmte Pfade oder Länder), verwende Conditional Rules.