# Mailserver

## Mailserver einrichten

{% hint style="warning" %}
Wenn Sie auf dem Applikationsserver eine **Konfigurationsdatei anpassen**, muss im nachhinein immer die **`setup.sh` ausgeführt** werden. Erst dann werden die Einstellungen wirksam. Sollten Sie sich jedoch schon im Loadbalancer befinden, so führen Sie die Nachfolgende Konfiguration auf der Service VM durch, wo Sentinel läuft.
{% endhint %}

1\. Öffnen Sie die Konfigurationsdatei in einem Editor Ihrer Wahl, zum Beispiel nano.

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

2\. Tragen Sie im Abschnitt E-Mail die Daten Ihres Mailservers ein.

```
 "email": {
    "sender": "'Firma' <firma@domain.com>",
    "host": "...",
    "port": "...",
    "sslTls": true,
    "user": "...",
    "pass": "...",
    "maxConnections": 5,
    "rateDelta": 1000,
    "rateLimit": 5
  },
```

In einigen Fällen bedarf es einer vom Standard abweichenden Konfiguration, zum Beispiel für einen *Office365*-*Mailserver* oder bei der bei einem Mailserver *ohne TLS*.

Ihre Konfiguration sieht dann bspw. folgendermaßen aus:

*Office365:*

```
"email":{
  "sender": "'Firma' <firma@domain.com>",
  "unqueued": true,
  "host": "smtp.office365.com",
  "requireTLS": false, 
  "ignoreTLS": false, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
  "port": 587,
  "user": "...",
  "pass": "...",
  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5,
  "service": "Outlook365"
}, 
```

*Local Exchange Server:*

```
"email":{
  "sender": "'Firma' <firma@domain.com>",
  "unqueued": true,
  "host": "...",
  "requireTLS": false, 
  "ignoreTLS": false, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
  "port": 587,
  "user": "...",
  "pass": "...",
  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5
}, 
```

*Mailserver ohne TLS:*

```
"email":{
  "sender": "'Firma' <firma@domain.com>",
  "unqueued": true,
  "host": "...",
  "requireTLS": false, 
  "ignoreTLS": true, 
  "rejectUnauthorized": false, 
  "secure": false, 
  "sslTls": false,
  "user": "...",
  "pass": "...",
  "maxConnections": 5,
  "rateDelta": 1000,
  "rateLimit": 5
},
```

3\. Speichern Sie die neue Konfigurationsdatei (Strg+o) und bestätigen Sie den Speicherprozess. Schließen Sie nano (Strg+x).

{% hint style="info" %}
Wenn Sie ein SPF-Record in Ihrer DNS-Konfiguration hinterlegt haben, passen Sie den Absender entsprechend an.
{% endhint %}

4\. Navigieren Sie in /opt/enginsight/enterprise

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

5\. Starten Sie die Applikation neu.

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

## Mailserver testen

Nachdem Sie Ihren Mailserver eingerichtet haben, können Sie in der Konsole auf dem Appserver überprüfen, ob die Konfiguration erfolgreich war.

1. Nutzen Sie die folgende Vorlage, ersetzen Sie \<SENTINEL\_CONTAINER-ID> und \<IHRE\_EMAIL\_ADRESSE> durch die zutreffenden Werte und führen Sie den Befehl anschließend auf dem Appserver aus.

   ```
   sudo docker exec <SENTINEL_CONTAINER-ID> ./sendTestMail --to <IHRE_EMAIL_ADRESSE>
   ```
2. Anschließend wird automatisch ein Mailtext an den Themis versandt. Bei korrekter Mailserver Konfiguration wird die Mail zugestellt (s. Bsp. weiter unten). Sollte diese nicht zugestellt werden, so checken Sie bitte den Themis auf eventuelle Fehler und führen Sie den Test anschließend erneut durch.&#x20;

#### Beispiel: korrekte Mail-Einstellungen

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FWK4PynsWlwZhYQNo9NQV%2FBildschirmfoto%202025-09-22%20um%2009.10.36.png?alt=media&#x26;token=b58f0802-26b5-4285-85d9-45d55cecfacd" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3532046264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LTMe1v0eboWCAUTQHbT-3758922206%2Fuploads%2FCgHY02N5isqcO2hua6xk%2FBildschirmfoto%202025-09-22%20um%2009.11.00.png?alt=media&#x26;token=be923960-c4d1-47a3-a35e-9900fbd67f02" alt=""><figcaption></figcaption></figure>