> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/de/systemadministration/smtp.md).

# SMTP

Diese Seite enthält Anweisungen zur Konfiguration und Administration von SMTP in einem VergeOS-System. [Abonnements](/run-the-platform/de/systemadministration/subscriptions-overview.md) (für Systemwarnungen und -benachrichtigungen verwendet) basieren auf einer funktionsfähigen SMTP-Konfiguration.

{% hint style="info" %}
**Direkt senden oder über einen SMTP-Relay**

SMTP kann so konfiguriert werden, dass E-Mails direkt vom integrierten VergeOS-Mailserver -ODER- über einen Relay-E-Mail-Server gesendet werden.
{% endhint %}

{% hint style="success" %}
Da SMTP von Natur aus eine komplexe und fehleranfällige Konfiguration (DNS, Reverse-DNS-Einträge, Firewall-Regeln usw.) erfordern kann, entscheiden sich einige Kunden aus Gründen der Benutzerfreundlichkeit, Sicherheit und Compliance für einen kommerziellen E-Mail-Relay-Dienst. Der Anbieter dieses Dienstes kann die korrekten Relay-Einstellungen für Ihre SMTP-Konfiguration bereitstellen.
{% endhint %}

## SMTP-Konfiguration

1. Beginnen Sie beim **SMTP-Dashboard (System > SMTP)**.
2. Klicken Sie **Einstellungen bearbeiten** im linken Menü.
3. Konfigurieren **Einstellungen:**
   * **TLS verwenden:** aktiviert/deaktiviert die TLS-Verschlüsselung; muss bei Verwendung eines E-Mail-Relay-Hosts den Anforderungen des Zielsystems entsprechen. Wenn unterstützt, verwenden Sie immer TLS.
   * **Hostname:** Bei Verwendung des integrierten SMTP-Servers stellen Sie sicher, dass Sie einen gültigen FQDN verwenden, der seinen Zweck eindeutig kennzeichnet, dass sichergestellt ist, dass der Hostname über DNS zur richtigen IP aufgelöst wird, und dass die korrekten SPF-, DMARC- und Reverse-DNS-Einträge für den Hostnamen vorhanden sind. Ein spezifischer Hostname kann auch bei der Verwendung eines Relays wichtig sein, abhängig von den Anforderungen und Richtlinien des Relay-Servers.
   * **Absendername:** der anzuzeigende Absendername in E-Mail-Nachrichten
   * **Absenderadresse:** die E-Mail-Absenderadresse, die in E-Mail-Nachrichten angezeigt werden soll
   * **Relay-Host:** Adresse des E-Mail-Relay-Servers (leer für direktes Senden)
   * **Relay-Port:** Vom Relay-Host verwendeter TCP-Port, z. B. 25 (unverschlüsselt), 587 (TLS), 465 (SSL/Legacy, veraltet); leer für direktes Senden
   * **SASL-Authentifizierung verwenden:** In der Regel sind bei Verwendung eines Relay-Hosts gültige Anmeldedaten erforderlich; aktivieren Sie diese Option, um Benutzername/Passwort einzugeben, die für den Zugriff auf den Relay-Server benötigt werden.
4. Klicken Sie **Senden** um die Konfiguration zu speichern.

## SMTP-Konfiguration testen

1. Beginnen Sie beim **SMTP-Dashboard (System > SMTP)**.
2. Klicken Sie **Test-E-Mail senden** im linken Menü.
3. Geben Sie eine **E-Mail-Adresse** an die gesendet werden soll.
4. Klicken Sie **Senden**.
5. Lesen Sie den [Problembehebung](#smtp-troubleshooting) Abschnitt, wenn die Testnachricht nicht empfangen wird.

## SMTP-Warteschlangenverwaltung

Der **E-Mail-Warteschlange** enthält E-Mail-Nachrichten, die auf das Senden warten.

### SMTP-Warteschlange löschen

Das Löschen der SMTP-Warteschlange kann in Situationen im Zusammenhang mit der E-Mail-Zustellung erforderlich sein, z. B. bei einem großen Rückstau nach einem längeren SMTP-Ausfall oder bei der Fehlersuche, um mit einem sauberen Zustand zu beginnen. Die folgenden Anweisungen löschen alle Einträge in der E-Mail-Warteschlange, und diese Einträge werden nicht neu erzeugt.

1. Beginnen Sie beim **SMTP-Dashboard (System > SMTP)**.
2. **Warteschlangeneinträge vor dem Löschen prüfen:** die neuesten Einträge werden im ***E-Mail-Warteschlange*** Abschnitt dieser Seite angezeigt; um eine größere Warteschlange anzuzeigen, klicken Sie auf den **E-Mail-Warteschlange** Eintrag im linken Menü.
3. Klicken Sie **Warteschlange löschen** im linken Menü.

### SMTP-Warteschlange leeren (beschleunigen)

Das Leeren der SMTP-Warteschlange beschleunigt das Senden von Nachrichten, indem der Mailserver gezwungen wird, jeden Eintrag in der Warteschlange erneut zu bewerten und den Versand erneut zu versuchen. Dies wird häufig verwendet, wenn zahlreiche Nachrichten aus einem früheren Problem (Fehlkonfiguration, Netzausfall, Dienstverzögerung usw.) hängen geblieben sind und nun behoben sein könnten. Das Leeren der Warteschlange löscht keine Nachrichten, sondern beschleunigt den Sendeprozess.

1. Beginnen Sie beim **SMTP-Dashboard (System > SMTP)**.
2. Klicken Sie **Warteschlange leeren** im linken Menü.
3. Klicken Sie **Ja** um den Vorgang zu bestätigen.

## SMTP-Protokolle

### Protokoll gesendeter Nachrichten anzeigen (Mail-Log)

1. Beginnen Sie beim **SMTP-Dashboard (System > SMTP)**.
2. Die neuesten Einträge im **Mail-Log** Abschnitt des Dashboards anzeigen.
3. Um weitere Einträge anzuzeigen (weiter zurückliegend), klicken Sie auf **Mail-Log** im linken Menü. **Weiter/Zurück** Schaltflächen unten auf der Seite ermöglichen es Ihnen, durch Seiten großer Protokolle zu blättern.

### SMTP-Systemereignisse anzeigen

1. Beginnen Sie beim **SMTP-Dashboard (System > SMTP)**.
2. Die neuesten Einträge im **Protokolle** Abschnitt unten im Dashboard.
3. Um weitere Einträge anzuzeigen (weiter zurückliegend), klicken Sie auf **Protokolle** im linken Menü. **Weiter/Zurück** Schaltflächen unten auf der Seite ermöglichen es Ihnen, durch Seiten großer Protokolle zu blättern.

## SMTP-Berichte

SMTP-Berichte bieten eine **Zusammenfassung der aktuellen SMTP-Aktivität**, die Informationen wie Warnungen, Fehler, gesendete/empfangene Bytes, Anzahl der Nachrichten nach Empfängern und Absendern usw. enthält. Verwenden Sie die Optionen im linken Menü, um **Heutiger Bericht** oder **Bericht von gestern**.

## SMTP-Fehlerbehebung

### SPAM-Ordner überprüfen

Stellen Sie sicher, dass Nachrichten nicht im SPAM-/Junk-Ordner des Empfängers landen.

### Protokolle überprüfen

Fehlermeldungen im SMTP-Protokoll können Informationen liefern, wenn E-Mail-Nachrichten fehlschlagen, z. B. Warnungen über falsche SMTP-Einstellungen oder deaktiviertes SMTP usw. Prüfen Sie den ***Protokolle*****&#x20;Abschnitt am unteren Ende** der SMTP-Seite.

### Geeignete Firewall-Regeln und Netzwerkrichtlinien überprüfen

Ausgehende SMTP-Verbindungen sind standardmäßig häufig blockiert. Stellen Sie sicher, dass Port 25, 587 oder 465 (je nach Konfiguration) offen und erlaubt sind; in einigen Fällen kann dazu die Kontaktaufnahme mit Ihrem Dienstanbieter erforderlich sein.

### Bei Verwendung eines Relays:

**Relay-Einstellungen bestätigen**

* Einige E-Mail-Server erfordern explizite Relay-Berechtigungen. Stellen Sie sicher, dass der E-Mail-Server Ihrem VergeOS-System das Weiterleiten von Nachrichten erlaubt, typischerweise durch Aktivierung der Authentifizierung oder das Whitelisting von IP-Adressen.
* Möglicherweise müssen Sie das Feld „Absenderadresse“ so konfigurieren, dass es dieselbe Domäne verwendet, an die Sie E-Mails senden. Typischerweise verfügt Ihr Relay-Host über die korrekten SPF-/DMARC-/Reverse-DNS-Einträge für Ihre Domäne, ist jedoch nicht berechtigt, E-Mails von der Standardadresse <system@cloud.verge.io> zu senden.
* Bestätigen Sie, dass die richtige Serveradresse und der richtige Port für den Relay-Server konfiguriert sind. Vergewissern Sie sich, dass Sie den vom Relay-Mail-System erwarteten Namen/die erwartete Adresse verwenden.
* Bestätigen Sie, dass die TLS-Einstellung den Anforderungen des Relay-Servers entspricht. Viele E-Mail-Server erfordern eine sichere TLS-Verbindung.

{% hint style="success" %}
**Einige E-Mail-Server verwenden STARTTLS, wobei die Verbindung auf einem standardmäßigen SMTP-Port (25 oder 587) unverschlüsselt beginnt und die Verschlüsselung ausgehandelt wird, nachdem die Verbindung hergestellt wurde.**
{% endhint %}

### Direkt senden:

**SPF-/DMARC-/Reverse-DNS-Einträge überprüfen**\
Wenn E-Mails als Spam markiert werden oder nicht zugestellt werden können, stellen Sie sicher, dass die Reverse-DNS-Einträge korrekt sind und dass Ihre Domäne über korrekte SPF- (Sender Policy Framework) und DMARC- (Domain-based Message Authentication, Reporting & Conformance) Einträge verfügt. Wenn diese Einträge nicht korrekt mit Ihrem System übereinstimmen, können versuchte Nachrichten als Identitätsmissbrauch erkannt werden, was zu Zustellungsfehlern und/oder als verdächtig markierten E-Mails führt. Wiederholter Identitätsmissbrauch kann dazu führen, dass Ihre Domäne/Ihre IP auf eine Blacklist gesetzt wird, was zukünftige E-Mail-Zustellungen beeinträchtigen kann.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/de/systemadministration/smtp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
