> 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/english/alerting/how-do-i-configure-sms-notifications-for-alerts-in-enginsight.md).

# How do I configure SMS notifications for alerts in Enginsight?

Enginsight uses Amazon SNS (Simple Notification Service) to send SMS notifications. To use this feature, you need to make changes to the Enginsight configuration file.&#x20;

In the following article, we will show you which steps you need to take.

{% stepper %}
{% step %}

### Create an AWS IAM user with the required access permissions

1. Log in to your AWS account and navigate to IAM (Identity and Access Management).
2. Create an IAM user with access to Amazon SNS. To do so, follow the [official AWS documentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html).

{% hint style="warning" %}
**Please note**: Enginsight assumes no liability for the content and topicality of third-party documentation.
{% endhint %}

3. Create an access key for the new user that grants access to third-party software. You will need this **Access Key** and the corresponding **Secret Access Key** later when adjusting the Enginsight configuration.
   {% endstep %}

{% step %}

### Adjust the Enginsight configuration

1. Log in to the **Enginsight Application Server**.
2. Open the Enginsight configuration file using the following command:

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

3. Navigate to the `sms` section and add the following:

<pre><code>"sms": {
    "limit": 20,
<strong>    "region": "&#x3C;AWSRegion>",
</strong><strong>    "accessKeyId": "&#x3C;IAMUserAccessKey>",
</strong><strong>    "secretAccessKey": "&#x3C;IAMUserSecretAccessKey>",
</strong><strong>    "senderId": "&#x3C;DefaultSenderIDAmazonSNS>"
</strong>  },
</code></pre>

Replace the placeholders in `<>` as follows:

<table><thead><tr><th width="263.53125">Placeholder</th><th>Description</th></tr></thead><tbody><tr><td><code>&#x3C;AWSRegion></code></td><td><p>Enter the AWS region from which your Amazon SNS instance sends messages. You can find an overview of all available AWS Regions in the <a href="https://docs.aws.amazon.com/de_de/general/latest/gr/end-user-messaging.html#end-user-messaging_region">official AWS documentation</a>.</p><div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Please note</strong>: Enginsight assumes no liability for the content and topicality of third-party documentation.</p></div></td></tr><tr><td><code>&#x3C;IAMUserAccessKey></code></td><td>Enter the access key that you created for your new IAM user.</td></tr><tr><td><code>&#x3C;IAMUserSecretAccessKey></code></td><td>Enter the secret access key that was created for your new IAM user.</td></tr><tr><td><code>&#x3C;DefaultSenderIDAmazonSNS></code></td><td>Enter the default sender ID that you can find in your Amazon SNS instance.</td></tr></tbody></table>

4. Save the configuration file (**Ctrl** + **o**) and confirm the save process. Close the configuration file (**Ctrl** + **x**).
   {% endstep %}

{% step %}

### Apply the changes on the Application Server

You now need to run the setup script for the Application Server again to apply your configuration changes.

1. Navigate to the Enginsight installation directory using the following command:

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

2. Run the setup script anew using the following command and confirm all prompts with the **Enter** key:

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

{% endstep %}

{% step %}

### Enable SMS notifications in the user interface

1. In the Enginsight user interface, navigate to **Settings** → **User Account** and enter a **Mobile number** in the **Your personal information** section so that Enginsight can send an SMS to this number when an alert is triggered.
2. When you [create a new alert](https://docs.enginsight.com/docs/manual/english/platform-usage/alerts/overview/add-alert), you can now enable the checkbox <i class="fa-square">:square:</i> next to **SMS** in the **Notification Service** section to receive an SMS when the corresponding alert is triggered.

<figure><img src="/files/HrOxSrLTrO3U1y6voIOv" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***
