# Rundeck

[<mark style="color:blue;">Rundeck</mark>](https://www.rundeck.com/) is an automation tool that helps you to make existing automation, scripts, and commands more secure, auditable, and easier to run.

Route detailed alerts from Rundeck to the right users in Squadcast.

### Using Rundeck as an Alert Source

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources%20(1)%20(2).png" alt="How to add Rundeck as alert source in Squadcast"><figcaption></figcaption></figure>

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources%20(2)%20(1).png" alt=""><figcaption></figcaption></figure>

2\. Select **Rundeck.** Copy the displayed **Webhook URL** to [configure](#create-a-squadcast-webhook-notification-in-rundeck) it within **Rundeck**. Finish by clicking **Add Alert Source** -> **Done.**

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-79b8131aa19fd7c90fe2439adc32ff81f7ba6029%2FRundeck%20(1).png" alt="Configure the Rundeck using webhook URL"><figcaption></figcaption></figure>

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-79b8131aa19fd7c90fe2439adc32ff81f7ba6029%2FRundeck%20(2)%20(1).png" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important:**

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### Create a Squadcast Webhook Notification in Rundeck

**(1)** Login to your Rundeck dashboard and head over to the **JOBS** section. You can either create a new Job or edit an existing one

**(a)** To create a new job, click on **Job Actions**. Then click on **New Job**

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-263bef1d72f387b81d0af8e86f09444214e3e0de%2Frundeck_2.png" alt="Create new jobs in Rundeck dashboard - Squadcast"><figcaption></figcaption></figure>

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-263bef1d72f387b81d0af8e86f09444214e3e0de%2Frundeck_2%20(1).png" alt=""><figcaption></figcaption></figure>

**(b)** To edit an existing job, click on the job you want to edit. Then click on **Action** and on **Edit this Job**

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-2625cfa768c78973b3376b7c0187623e0ef78ddd%2Frundeck_3.png" alt="Edit new/existing jobs in Rundeck dashboard"><figcaption></figcaption></figure>

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-2625cfa768c78973b3376b7c0187623e0ef78ddd%2Frundeck_3%20(1).png" alt=""><figcaption></figcaption></figure>

**(2)** Navigate to the **Notifications** tab, then select when Rundeck should send alerts to Squadcast. Next, click on **+Add Notification**

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-adb348b4504f4ba9eade7b40f8d4da11ead06040%2Frundeck_4.png" alt="Set-up the alert notification for Rundeck"><figcaption></figcaption></figure>

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-adb348b4504f4ba9eade7b40f8d4da11ead06040%2Frundeck_4%20(1).png" alt=""><figcaption></figcaption></figure>

**(3)** Click on **Select a Notification** and select **Send Webhook** as the **Notification Type**

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-7473539ba9a3f97d14ff41fd808899a1f757596c%2Frundeck_5.png" alt="Select the send webhook as notification type"><figcaption></figcaption></figure>

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-7473539ba9a3f97d14ff41fd808899a1f757596c%2Frundeck_5%20(1).png" alt=""><figcaption></figcaption></figure>

**(4)** Paste the previously copied Squadcast Webhook URL in the placeholder for **URL(s)**. Select the Payload Format as **JSON** and Method as **POST**. Then, click on **Save**

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ba459a07efd1dd0873159d22fdc1b54e79b3e3dc%2Frundeck_6.png" alt="Select the payload format as JSON and method as POST"><figcaption></figcaption></figure>

<figure><img src="https://github.com/solarwinds-cloud/sq-Gitbook/blob/main/.gitbook/assets/21spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ba459a07efd1dd0873159d22fdc1b54e79b3e3dc%2Frundeck_6%20(1).png" alt=""><figcaption></figcaption></figure>

That's it, you are good to go! Your Rundeck integration is now complete. Whenever Rundeck fires an alert, an incident will be created in Squadcast for it. Also, when a job is completed in Rundeck, the corresponding incident gets **auto-resolved** in Squadcast.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*
