> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Eigene E-Mail-Domain

> Richte deine eigene Domain als E-Mail-Absender ein, um E-Mails direkt über deine Unternehmens-Domain zu versenden.

## Voraussetzungen

<Note>
  Um E-Mails über deine eigene Domain zu versenden, muss die Domain zunächst vom Fynn-Team eingerichtet werden. Schreibe uns eine kurze E-Mail an [hi@fynn.eu](mailto:hi@fynn.eu) mit der gewünschten Domain.
</Note>

Nachdem das Fynn-Team deine Domain eingerichtet hat, musst du zwei Schritte durchführen:

1. **Domain-Verifizierung** - Bestätige, dass du der Inhaber der Domain bist
2. **DNS-Konfiguration** - Richte SPF, DKIM und optionale Einträge ein, um eine zuverlässige Zustellung sicherzustellen

***

## Schritt 1: Domain verifizieren

Um zu bestätigen, dass du Inhaber der Domain bist, muss ein TXT-Record in deinen DNS-Einstellungen hinterlegt werden.

<Steps>
  <Step title="Verifizierungsdaten erhalten">
    Nachdem das Fynn-Team deine Domain angelegt hat, erhältst du einen Verifizierungscode. Dieser sieht beispielsweise so aus:

    | Typ | Name              | Wert                                         |
    | --- | ----------------- | -------------------------------------------- |
    | TXT | `@` (Root-Domain) | `postal-verification deinVerifizierungsCode` |
  </Step>

  <Step title="TXT-Record anlegen">
    Melde dich bei deinem DNS-Provider an (z.B. Cloudflare, IONOS, Hetzner, AWS Route 53) und erstelle einen neuen **TXT-Record** mit den erhaltenen Daten.
  </Step>

  <Step title="Verifizierung abschliessen">
    Klicke in der Verwaltungsoberfläche auf **"Verify TXT record"**, um die Verifizierung zu starten. Der DNS-Eintrag wird geprüft und die Domain bestätigt.

    <Tip>
      DNS-Änderungen können bis zu 24 Stunden dauern, bis sie weltweit verfügbar sind. In der Regel ist der Eintrag jedoch innerhalb weniger Minuten sichtbar.
    </Tip>
  </Step>
</Steps>

***

## Schritt 2: DNS-Konfiguration

Nach erfolgreicher Verifizierung müssen weitere DNS-Einträge konfiguriert werden, um eine zuverlässige E-Mail-Zustellung sicherzustellen.

### SPF-Record (erforderlich)

Der SPF-Record legt fest, welche Server E-Mails im Namen deiner Domain versenden dürfen.

Erstelle einen **TXT-Record** auf der Root-Domain (`@`) mit folgendem Inhalt:

```
v=spf1 a mx include:spf.pes.netzfabrik.eu ~all
```

<Warning>
  Falls du bereits einen SPF-Record hast (z.B. für einen anderen E-Mail-Dienst), füge lediglich `include:spf.pes.netzfabrik.eu` zu deinem bestehenden Record hinzu. Es darf pro Domain nur **einen** SPF-Record geben.

  **Beispiel:** Dein bestehender Record `v=spf1 include:_spf.google.com ~all` wird zu:

  ```
  v=spf1 include:_spf.google.com include:spf.pes.netzfabrik.eu ~all
  ```
</Warning>

### DKIM-Record (erforderlich)

DKIM signiert ausgehende E-Mails kryptografisch und stellt sicher, dass sie nicht manipuliert wurden.

Erstelle einen **TXT-Record** mit dem Namen und Inhalt, die du vom Fynn-Team erhältst. Der Eintrag sieht beispielsweise so aus:

| Typ | Name                      | Wert                                       |
| --- | ------------------------- | ------------------------------------------ |
| TXT | `postal-XXXXX._domainkey` | `v=DKIM1; t=s; h=sha256; p=MIGfMA0GCSq...` |

<Tip>
  Der genaue Name und Wert des DKIM-Records wird individuell für deine Domain generiert und in der Verwaltungsoberfläche angezeigt.
</Tip>

### Return Path (empfohlen)

Der Return Path verbessert die Zustellbarkeit und hilft bei der DMARC-Ausrichtung.

Erstelle einen **CNAME-Record**:

| Typ   | Name   | Wert                   |
| ----- | ------ | ---------------------- |
| CNAME | `psrp` | `rp.pes.netzfabrik.eu` |

### MX-Records (optional)

MX-Records sind nur erforderlich, wenn du auch **eingehende** E-Mails über Fynn empfangen möchtest. Für den reinen Versand von Benachrichtigungen sind sie nicht notwendig.

Falls gewünscht, erstelle einen **MX-Record** mit Priorität 10:

| Typ | Priorität | Wert                   |
| --- | --------- | ---------------------- |
| MX  | 10        | `mx.pes.netzfabrik.eu` |

***

## DNS-Einträge prüfen

Nachdem du alle DNS-Einträge konfiguriert hast, kannst du in der Verwaltungsoberfläche über **"Check my records are correct"** prüfen, ob alle Einträge korrekt gesetzt sind. Für jeden Eintrag wird der aktuelle Status angezeigt.

<Snippet file="questions-book-call-hint.mdx" />
