# Erste Schritte

Diese Anleitung führt dich durch die Ersteinrichtung, um deine Website über smoxy laufen zu lassen. Der Ablauf ist derselbe, unabhängig davon, welches Modul du nutzt — Bildoptimierung, Acceleration oder Security. Sobald der Traffic über smoxy fließt, kannst du deine Module aktivieren.

**Was du brauchst:**

* Einen smoxy-Account
* Die IP-Adresse und den Port deines Origin-Servers
* Zugang zur DNS-Verwaltung deiner Domain

***

### Schritt 1: Site erstellen

1. Klicke auf **Erste Site erstellen** (oder den **+**-Button, wenn du bereits Sites hast)
2. Gib die URL der Website ein, die du optimieren möchtest (z. B. `example.com`)
3. Wähle einen **Site-Typ** (Produktion oder Staging — dient nur deiner eigenen Organisation)
4. Gib deiner Site einen **Namen** (wird automatisch aus der URL übernommen, kann aber geändert werden)
5. Füge **Hostnamen** hinzu — das sind die Domains, die die Konfiguration dieser Site nutzen sollen (z. B. `example.com`, `www.example.com`). Du kannst später weitere hinzufügen.

{% hint style="info" %}
**Was ist eine Site?** Eine Site ist ein wiederverwendbares Bündel von Einstellungen — Caching, Sicherheit, Optimierung — das du einer oder mehreren Domains zuweist. Siehe [Was ist eine Site?](https://docs.smoxy.eu/sites/was-ist-eine-site) für Details.
{% endhint %}

***

### Schritt 2: SSL einrichten

Für jeden Hostnamen braucht smoxy ein SSL-Zertifikat. Du hast zwei Möglichkeiten:

#### Automatisch verwaltet (empfohlen)

smoxy generiert und erneuert Zertifikate automatisch über Let's Encrypt. Zur Bestätigung der Domain-Inhaberschaft musst du einen DNS-CNAME-Eintrag erstellen:

| Eintragstyp | Name                          | Wert                                                     |
| ----------- | ----------------------------- | -------------------------------------------------------- |
| CNAME       | `_acme-challenge.example.com` | Wird im Setup-Wizard angezeigt (Kopier-Button vorhanden) |

Nachdem du den Eintrag bei deinem DNS-Anbieter hinzugefügt hast, klicke in smoxy auf **Einträge verifizieren**. Nach der Verifizierung wird das Zertifikat automatisch generiert.

{% hint style="info" %}
**Hinweis:** Dieser DNS-Eintrag dient nur der Zertifikatserstellung — er leitet den Traffic noch nicht über smoxy.
{% endhint %}

#### Selbst verwaltet

Wenn du ein eigenes Zertifikat verwenden möchtest, klicke auf **Eigenes SSL-Zertifikat hochladen** und füge dein Zertifikat (PEM-Format) und den privaten Schlüssel ein. Siehe Selbst verwaltete SSL-Zertifikate für Formatanforderungen.

***

### Schritt 3: Origin konfigurieren

Der Origin ist dein Backend-Server, an den smoxy Anfragen weiterleitet.

| Feld                    | Beschreibung                                                                                                          |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Schema**              | `https` (Standard) oder `http`                                                                                        |
| **IP-Adresse**          | Die IPv4-Adresse deines Servers (z. B. `12.3.45.6`)                                                                   |
| **Port**                | Standard `443` für HTTPS, `80` für HTTP                                                                               |
| **Hostname** (optional) | Überschreibt den Host-Header, der an deinen Server gesendet wird. Leer lassen, um die eingehende Domain zu verwenden. |

Du kannst auch einen bestehenden Origin oder Load Balancer auswählen, wenn du bereits einen unter **Organisation > Origins & Loadbalancer** konfiguriert hast.

***

### Schritt 4: Go-Live-Checkliste abschließen

Nach dem Setup zeigt das Dashboard eine Go-Live-Checkliste mit vier Punkten:

1. **Ziel einrichten** — Origin oder Load Balancer konfiguriert
2. **Konnektivität** — smoxy kann deinen Origin erreichen (klicke **Wiederholen** zum Testen)
3. **Hostnamen** — Mindestens ein Hostname hinzugefügt
4. **SSL** — Gültiges Zertifikat für deine Hostnamen

Alle vier Punkte müssen grün sein, bevor du live gehen kannst.

***

### Schritt 5: DNS auf smoxy umstellen

Dies ist der Schritt, der den Traffic deiner Besucher tatsächlich über smoxy leitet. Das Dashboard zeigt die genauen CNAME-Einträge, die du setzen musst:

| Eintragstyp | Name              | Wert                                                  |
| ----------- | ----------------- | ----------------------------------------------------- |
| CNAME       | `example.com`     | Wird im Dashboard angezeigt (Kopier-Button vorhanden) |
| CNAME       | `www.example.com` | Wird im Dashboard angezeigt (Kopier-Button vorhanden) |

Setze diese Einträge bei deinem DNS-Anbieter. Verwende einen niedrigen TTL-Wert (z. B. 300 Sekunden / 5 Minuten), damit du bei Bedarf schnell zurückkehren kannst.

{% hint style="info" %}
**Hinweis:** DNS-Änderungen können bis zu 24–48 Stunden benötigen, um weltweit zu propagieren, obwohl die meisten Änderungen innerhalb von Minuten sichtbar sind.
{% endhint %}

#### Traffic verifizieren

Aktiviere den **Live-Modus** im Dashboard, um eingehende Anfragen in Echtzeit zu sehen. Sobald du Traffic im Requests-Diagramm siehst, funktioniert dein Setup.

***

### Schritt 6: Module aktivieren

Zu diesem Zeitpunkt fließt der Traffic über smoxy, aber es findet noch keine Optimierung statt. Aktiviere die Module, die du erworben hast:

#### Bildoptimierung

Komprimiert Bilder automatisch und konvertiert sie in moderne Formate (WebP, AVIF) basierend auf Browser-Unterstützung. Aktiviere sie in deinen Site-Einstellungen und konfiguriere die Qualitätsschwellenwerte.

[Bildoptimierung einrichten →](https://docs.smoxy.eu/sites/bildoptimierung)

#### Acceleration

Cached HTML-Seiten am Edge für nahezu sofortige Auslieferung. Aktiviere sie in deinen Site-Einstellungen. Stelle sicher, dass du dynamische Seiten (Warenkorb, Checkout, Konto) mit Conditional Rules ausschließt.

[Acceleration einrichten →](https://docs.smoxy.eu/sites/acceleration)

#### Security

Aktiviert die Web Application Firewall (WAF) mit verwalteten Regeln, die vor gängigen Bedrohungen schützen. Sicher für alle Sites zu aktivieren — keine Konfiguration nötig, um loszulegen.

[Sicherheit & WAF einrichten →](https://docs.smoxy.eu/sites/sicherheit-and-waf)

***

### Wie geht es weiter?

* [Erweitertes Caching](https://docs.smoxy.eu/sites/erweitertes-caching) — TTL, Cache-Keys und Cache-Tags fein abstimmen
* [Dashboard](https://docs.smoxy.eu/sites/dashboard) — Traffic überwachen, Cache-Treffer verfolgen und deine Site verwalten
* [Regeln](https://docs.smoxy.eu/regeln/regelubersicht) — Regeln erstellen, um das Verhalten nach Pfad, Land oder Gerät anzupassen
* [Wie SSL in smoxy funktioniert](https://docs.smoxy.eu/ssl-and-zertifikate/wie-ssl-in-smoxy-funktioniert) — Zertifikatsverwaltung im Detail verstehen