# Uptime Kuma Integration

Connecting [Uptime Kuma](https://github.com/louislam/uptime-kuma) to ilert allows uptime failures – such as service downtime or unreachable hosts – to generate technical alerts for on-call teams. Escalations are automated to reduce response time and improve overall availability.

## In ilert: Create an Uptime Kuma alert source

1. Go to **Alert sources** --> **Alert sources** and click on **Create new alert source**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FjX0cS4q7woTXKajZmc1W%2FScreenshot%202023-08-28%20at%2010.21.10.png?alt=media&#x26;token=8ef3666b-84eb-4b51-abee-f07303313941" alt=""><figcaption></figcaption></figure>

2. Search for **Uptime Kuma** in the search field, click on the Uptime Kuma tile and click on **Next**.&#x20;

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FlXzQlJpaTFSR49AZk0xA%2FScreenshot%202023-08-28%20at%2010.24.23.png?alt=media&#x26;token=cffeacb4-57b9-47d4-827d-b0f6b1afd914" alt=""><figcaption></figcaption></figure>

3. Give your alert source a name, optionally assign teams and click **Next**.
4. Select an **escalation policy** by creating a new one or assigning an existing one.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FNnuZqONaIhbOf6fn4OkZ%2FScreenshot%202023-08-28%20at%2011.37.47.png?alt=media&#x26;token=8a74f7b5-5bd2-4eea-97fa-1c1dbb041333" alt=""><figcaption></figcaption></figure>
5. Select you [Alert grouping](https://docs.ilert.com/alerting/configure-alerting/alert-sources#alert-grouping) preference and click **Continue setup**. You may click **Do not group alerts** for now and change it later.&#x20;

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FueugN4JgHn1c90ggFA6u%2FScreenshot%202023-08-28%20at%2011.38.24.png?alt=media&#x26;token=b8009daf-3ca8-4264-a6fa-e42ef7333205" alt=""><figcaption></figcaption></figure>
6. The next page show additional settings such as customer alert templates or notification prioritiy. Click on **Finish setup** for now.
7. On the final page, an API key and / or webhook URL will be generated that you will need later in this guide.

   <figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2Fi3TIOBvNYBQfDtNpmm0A%2FScreenshot%202023-08-28%20at%2011.47.34.png?alt=media&#x26;token=6cae965a-e448-4443-8c20-37cf501c43b2" alt=""><figcaption></figcaption></figure>

## In Uptime Kuma: Add ilert Webhook

1. Select any monitor you want to send notifications from.

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FQWjaNdw0zZgQz718yA2q%2F3.png?alt=media&#x26;token=27a65be5-5019-4cf2-bc79-7de4166e0abe" alt=""><figcaption></figcaption></figure>

2. Click on **Edit**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2F6FkzMAdrU4RjAv0oYUP8%2F4.png?alt=media&#x26;token=41c7acae-6000-4004-a059-bba0e031a537" alt=""><figcaption></figcaption></figure>

3. Now click on **Setup Notification**

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FzezStIwKfCnC2CtofHIL%2F5.png?alt=media&#x26;token=5855ccef-3c06-4955-9792-645f193fa21f" alt=""><figcaption></figcaption></figure>

4. Choose **Webhook** in the Notification Type field
5. Add a **Friendly Name** for your the notification
6. In Post URL add the [previous](#in-ilert-create-uptime-kuma-alert-source) created **Uptime Kuma URL**
7. Choose **application/json** as Content Type

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FC1sqi42Ko29fgcEv0Ohv%2F6.png?alt=media&#x26;token=5ee3096f-1f24-4ec7-9b17-c419843589a7" alt="" width="375"><figcaption></figcaption></figure>

8. Optional: click on **Test** to test the notification

<figure><img src="https://3394882078-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M76ygPnS4HUcFSX8ulm%2Fuploads%2FdJzQYwHojpxp3wHCPp4n%2F7.png?alt=media&#x26;token=b5e25c7c-d98d-45ce-98a6-6cd857003c39" alt="" width="350"><figcaption></figcaption></figure>

9. Click on **Save** to finish the Setup

## FAQ

**Will alerts in ilert be resolved automatically?**

Yes, as soon as the monitor in Uptime Kuma sends an "OK" notification, the associated alert is automatically resolved in ilert.
