> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/knowledge-base/konfiguration/wie-konfiguriere-ich-in-enginsight-einen-email-server-fur-benachrichtigungen.md).

# Wie konfiguriere ich in Enginsight einen E-Mail-Server für Benachrichtigungen (Legacy)?

{% hint style="info" %}
**Bitte beachte**: Die Einrichtung des E-Mail-Servers über die Enginsight Konfigurationsdatei auf dem Applikationsserver ist eine **Legacy-Funktionalität**. Ab **Release 4.9.1** kann der E-Mail-Server über die Enginsight Plattform unter **Einstellungen** → [E-Mail-Server](https://docs.enginsight.com/docs/manual/administration/einstellungen/email-server) konfiguriert werden.
{% endhint %}

***

Damit du E-Mail-Benachrichtigungen erhältst, wenn bspw. in der Enginsight Plattform ein Alarm ausgelöst wird, musst du deinen E-Mail-Server in der Enginsight Konfigurations-Datei einrichten. Im Folgenden zeigen wir dir, welche Schritte du dafür vornehmen musst.

***

## E-Mail-Server einrichten

{% hint style="warning" %}
**Bitte beachte**: Die folgenden Schritte müssen *auf dem Enginsight Applikationsserver* durchgeführt werden. Wenn du eine [Lastverteilung](https://docs.enginsight.com/docs/manual/installation-und-konfiguration/installation-und-konfiguration/setup-mit-lastverteilung) einsetzt, musst du den E-Mail-Server zusätzlich auf der virtuellen Maschine einrichten, auf der die [Enginsight Services](https://docs.enginsight.com/docs/manual/installation-und-konfiguration/installation-und-konfiguration/setup-mit-lastverteilung/server-fur-die-enginsight-services) laufen.
{% endhint %}

{% stepper %}
{% step %}
Melde dich auf dem Enginsight Applikationsserver an, sofern du dies noch nicht getan hast.

Du kannst dies entweder direkt in der Konsole deiner Applikationsserver-VM oder per Fernzugriff über SSH (Secure Shell) von einer anderen Maschine aus tun.
{% endstep %}

{% step %}
Öffne mit folgendem Befehl die Enginsight Konfigurationsdatei:

```
sudo nano /opt/enginsight/enterprise/conf/services/config.json
```

{% endstep %}

{% step %}
Navigiere zum Abschnitt `email` und passe ihn wie folgt an:

<pre><code>"email": {
<strong>    "sender": "'&#x3C;Firmenname>' &#x3C;AbsenderMailAdresse>",
</strong><strong>    "host": "&#x3C;HostnameMailServer>",
</strong><strong>    "port": "&#x3C;PortMailServer>",
</strong>    "sslTls": true,
<strong>    "user": "&#x3C;BenutzernameMailServer>",
</strong><strong>    "pass": "&#x3C;PasswortMailServer>",
</strong>    "maxConnections": 5,
    "rateDelta": 1000,
    "rateLimit": 5
  },
</code></pre>

{% hint style="info" %}
Vergiss dabei nicht, die Platzhalter in `<>` entsprechend zu ersetzen:

* `<Firmenname>`
* `<AbsenderMailAdresse>`
* `<HostnameMailServer>`
* `<PortMailServer>`
* `<BenutzernameMailServer>`
* `<PasswortMailServer>`
  {% endhint %}

{% hint style="danger" %}
**Bitte beachte**: Wenn du einen SPF-Eintrag (Sender Policy Framework) in deinem DNS hinterlegt hast, ist die Angabe eines Senders zwingend notwendig!
{% endhint %}

{% hint style="warning" %}
**Bitte beachte**: In manchen Fällen bedarf es einer abweichenden Konfiguration. Beispielkonfigurationen findest du im Abschnitt [Abweichende Konfigurationen](#abweichende-konfigurationen).
{% endhint %}
{% endstep %}

{% step %}
Speichere die Änderungen in der Konfigurationsdatei (**Strg** + **o**) und bestätige den Speicherprozess. Schließe die Datei (**Strg** + **x**).
{% endstep %}

{% step %}
Nun musst du das Setup-Skript für den Applikationsserver noch einmal ausführen, um deine Anpassungen zu übernehmen.

Navigiere dazu mit folgendem Befehl ins Enginsight Installationsverzeichnis:

```
cd /opt/enginsight/enterprise
```

{% endstep %}

{% step %}
Führe mit folgendem Befehl das Setup-Skript neu aus und und bestätige alle Abfragen mit der **Enter**-Taste:

```
sudo ./setup.sh
```

{% endstep %}
{% endstepper %}

### Abweichende Konfigurationen

In manchen Fällen bedarf es einer vom Standard abweichenden Konfiguration des E-Mail-Servers. Im Folgenden findest du drei Beispielkonfigurationen für einen [Microsoft 365-E-Mail-Server](#beispielkonfiguration-fur-einen-microsoft-365-mailserver), einen [lokalen Microsoft Exchange-Server](#beispielkonfiguration-fur-einen-lokalen-exchange-server) und einen [E-Mail-Server ohne TLS](#beispielkonfiguration-fur-einen-mailserver-ohne-tls):

#### Beispielkonfiguration für einen Microsoft 365-E-Mail-Server

<pre><code>"email":{
<strong>  "sender": "'&#x3C;Firmenname>' &#x3C;AbsenderMailAdresse>",
</strong>  "unqueued": true,
  "host": "smtp.office365.com",
  "requireTLS": false, 
  "ignoreTLS": false, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
  "port": 587,
<strong>  "user": "&#x3C;BenutzernameMailServer>",
</strong><strong>  "pass": "&#x3C;PasswortMailServer>",
</strong>  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5,
  "service": "Outlook365"
}, 
</code></pre>

{% hint style="info" %}
Vergiss dabei nicht, die Platzhalter in `<>` entsprechend zu ersetzen:

* `<Firmenname>`
* `<AbsenderMailAdresse>`
* `<BenutzernameMailServer>`
* `<PasswortMailServer>`
  {% endhint %}

#### Beispielkonfiguration für einen lokalen Microsoft Exchange-Server

<pre><code>"email":{
<strong>  "sender": "'&#x3C;Firmenname>' &#x3C;AbsenderMailAdresse>",
</strong>  "unqueued": true,
<strong>  "host": "&#x3C;HostnameMailServer>",
</strong>  "requireTLS": false, 
  "ignoreTLS": false, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
  "port": 587,
<strong>  "user": "&#x3C;BenutzernameMailServer>",
</strong><strong>  "pass": "&#x3C;PasswortMailServer>",
</strong>  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5
}, 
</code></pre>

{% hint style="info" %}
Vergiss dabei nicht, die Platzhalter in `<>` entsprechend zu ersetzen:

* `<Firmenname>`
* `<AbsenderMailAdresse>`
* `<HostnameMailServer>`
* `<BenutzernameMailServer>`
* `<PasswortMailServer>`
  {% endhint %}

#### Beispielkonfiguration für einen E-Mail-Server ohne TLS

<pre><code>"email":{
<strong>  "sender": "'&#x3C;Firmenname>' &#x3C;AbsenderMailAdresse>",
</strong>  "unqueued": true,
<strong>  "host": "&#x3C;HostnameMailServer>",
</strong>  "requireTLS": false, 
  "ignoreTLS": true, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
<strong>  "user": "&#x3C;BenutzernameMailServer>",
</strong><strong>  "pass": "&#x3C;PasswortMailServer>",
</strong>  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5
},
</code></pre>

{% hint style="info" %}
Vergiss dabei nicht, die Platzhalter in `<>` entsprechend zu ersetzen:

* `<Firmenname>`
* `<AbsenderMailAdresse>`
* `<HostnameMailServer>`
* `<BenutzernameMailServer>`
* `<PasswortMailServer>`
  {% endhint %}

***

## E-Mail-Server testen

Nachdem du den E-Mail-Server eingerichtet hast, kannst du über die Konsole auf dem Applikationsserver testen, ob die Konfiguration erfolgreich war.

Nimm dazu folgende Schritte vor:

{% stepper %}
{% step %}
Nutze folgenden Befehl, um die ID des Sentinel-Containers zu erhalten, der auf dem Applikationsserver installiert ist:

```
sudo docker ps --filter "name=sentinel" --format "{{.ID}}"
```

{% hint style="danger" %}
**Bitte beachte**: Dieser Schritt ist **zwingend notwendig**, da bei der Ausführung des Setup-Skripts für den Applikationsserver alle Container-IDs neu erzeugt werden!
{% endhint %}
{% endstep %}

{% step %}
Nutze folgenden Befehl, um eine Test-E-Mail zu versenden:

```
sudo docker exec <SentinelContainerID> ./sendTestMail --to <EmpfängerMailAdresse>
```

{% hint style="info" %}
Vergiss dabei nicht, `<SentinelContainerID>` und `<EmpfängerMailAdresse>` entsprechend zu ersetzen.
{% endhint %}
{% endstep %}

{% step %}
Wenn die Konfiguration wie gewünscht funktioniert hat, wird dir in der Konsole folgendes angezeigt:

<figure><img src="https://3365013050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm7kFsCWkwO5xnjJ7eSF0%2Fuploads%2F9sqMRvmv3C9iDYEdmDb7%2FEnginsight-Mailserverkonfiguration-erfolgreich.jpg?alt=media&amp;token=0cc0f3d4-3abe-4f3c-8c6f-407580883c15" alt=""><figcaption></figcaption></figure>

Zudem solltest du eine Test-Email an der angegebenen Empfänger-Email-Adresse erhalten haben:

<figure><img src="https://3365013050-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fm7kFsCWkwO5xnjJ7eSF0%2Fuploads%2FyUwBGGnTJn7xGMP3pqaH%2FEnginsight-Test-Email.jpg?alt=media&amp;token=785f0f3d-c09b-48b5-bbac-123de97f4713" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***
