# 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)*.*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.squadcast.com/integrations/alert-source-integrations-native/rundeck.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
