> ## Documentation Index
> Fetch the complete documentation index at: https://infisical.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Rundeck connection

> Learn how to configure a Rundeck Connection for Infisical.

Infisical supports connecting to Rundeck using an **API Token**.

## Generate a Rundeck API token

**1. Open your Rundeck profile menu**

Log in to your Rundeck instance and select the user icon in the top-right corner.

![Rundeck profile menu](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/rundeck/step-1.png)

**2. Go to your Profile**

Select **Profile** from the dropdown.

![Select Profile](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/rundeck/step-2.png)

**3. Add a new User API Token**

In the **User API Tokens** section, select the **+** button.

![User API Tokens](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/rundeck/step-3.png)

**4. Generate the token**

In the **Generate New Token** dialog, enter:

* **Name**: a label to identify the token (e.g., `INFISICAL_TOKEN`)
* **User**: the username associated with the token
* **Roles**: comma-separated roles/groups, or leave blank to use all of your current roles
* **Expiration in**: an optional lifetime; set to `0` for the maximum allowed duration

Click **Generate New Token**.

![Generate New Token](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/rundeck/step-4.png)

> [!NOTE]
>
> The API token inherits the access of the user and roles it is generated with. Grant only the
> permissions required to read projects and manage Key Storage for your target projects.

**5. Copy the API Token**

Copy the generated token and store it securely, as you won't be able to view it again after
closing the dialog. Click **Close** when done.

![Save Your new Token](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/rundeck/step-5.png)

> [!NOTE]
>
> If you configure an expiration for your API token, you must manually rotate to a new token
> before it expires to prevent service interruption.

## Setup Rundeck connection in Infisical

> [tab] Infisical UI
>
> **1. Add a Rundeck Connection**
>
> In your Infisical dashboard, navigate to the **Integrations** tab in the desired project,
> select **App Connections**, and select **+ Add Connection**. Search for and select the
> **Rundeck** option.
>
> ![Select Rundeck Connection](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/rundeck/step-6.png)
>
> **2. Fill out the Rundeck Connection form**
>
> Complete the connection form by entering:
>
> * A descriptive **Name** for the connection (must be slug-friendly)
> * An optional **Description** for future reference
> * The **Method** (**API Token**)
> * The **Rundeck Instance URL** (e.g., `https://rundeck.example.com`)
> * The **Rundeck API Token** you generated above
>
> Click **Connect to Rundeck**.
>
> ![Rundeck Connection Form](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/rundeck/step-7.png)
>
> **3. Connection Created**
>
> Your **Rundeck Connection** is established and ready to use with your Infisical project.
>
> ![Rundeck Connection Created](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/rundeck/step-8.png)

> [tab] API
>
> To create a Rundeck Connection, make an API request to the [Create Rundeck
> Connection](https://infisical.com/docs/api-reference/endpoints/app-connections/rundeck/create.md) API endpoint.
>
> ### Sample request
>
> ```bash Request theme={"dark"}
> curl    --request POST \
>         --url https://app.infisical.com/api/v1/app-connections/rundeck \
>         --header 'Content-Type: application/json' \
>         --data '{
>             "name": "my-rundeck-connection",
>             "method": "api-token",
>             "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
>             "credentials": {
>                 "instanceUrl": "https://rundeck.example.com",
>                 "apiToken": "..."
>             }
>         }'
> ```
>
> ### Sample response
>
> ```bash Response theme={"dark"}
> {
>   "appConnection": {
>     "id": "e5d18aca-86f7-4026-a95e-efb8aeb0d8e6",
>     "name": "my-rundeck-connection",
>     "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
>     "description": null,
>     "version": 1,
>     "orgId": "6f03caa1-a5de-43ce-b127-95a145d3464c",
>     "createdAt": "2025-04-23T19:46:34.831Z",
>     "updatedAt": "2025-04-23T19:46:34.831Z",
>     "isPlatformManagedCredentials": false,
>     "credentialsHash": "7c2d371dec195f82a6a0d5b41c970a229cfcaf88e894a5b6395e2dbd0280661f",
>     "app": "rundeck",
>     "method": "api-token",
>     "credentials": {
>       "instanceUrl": "https://rundeck.example.com"
>     }
>   }
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.