> For the complete documentation index, see [llms.txt](https://support.incidents.cloud.solarwinds.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.incidents.cloud.solarwinds.com/integrations/alert-source-integrations-native/rundeck.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://support.incidents.cloud.solarwinds.com/integrations/alert-source-integrations-native/rundeck.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
