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

# Coolify connection

> Learn how to configure a Coolify connection for Infisical.

A Coolify connection authenticates Infisical to Coolify Cloud or your self-hosted Coolify instance with an [API token](https://coolify.io/docs/core/security/credentials/api-tokens), so Infisical can list your applications, services, and databases and manage their environment variables.

> [!NOTE]
>
> This guide only authenticates Infisical with Coolify. Once the app connection is ready, you can [use it to set up integrations](#step-3-configure-integrations).

## Prerequisites

* The Owner or Admin role in the Coolify team that owns the resources you plan to sync to
* If you self-host Coolify, API access turned on under **Settings** > **Advanced** in Coolify
* If your Coolify instance isn't reachable from the internet, a [Gateway](https://infisical.com/docs/documentation/platform/gateways/overview.md) with network access to it

## Step 1: Create a Coolify API token

Infisical needs a Coolify API token that can read, write, and delete environment variables.

**Step 1**

Log in to Coolify and switch to the team that owns the resources you plan to sync to. A token can only access its own team's resources.

**Step 2**

In the sidebar, select **Keys & Tokens**, then **API Tokens**, and select **New token**.

**Step 3**

Fill in the **New API token** form:

* **Description**: A name that identifies the token, such as `infisical`
* **Expires in**: How long the token stays valid; once it expires, the sync fails until you update the connection with a new token
* **Permissions**: `read`, `read:sensitive`, `write`, and `delete`
* **Resources**: **All resources in the team**, or **Selected projects, environments, or resources** to limit the token to the resources you plan to sync to

Then select **Create token**.

**Step 4**

Copy the token from the **Copy your token** window and store it securely. Coolify shows it only once.

## Step 2: Create the app connection

Next, create the app connection in Infisical.

> [!TIP]
>
> To create the connection using the API, use the Coolify [Create](https://infisical.com/docs/api-reference/endpoints/app-connections/coolify/create.md) endpoint. If the instance isn't reachable from the internet, include the ID of a Gateway that can reach it as `gatewayId`, or the ID of a [Gateway pool](https://infisical.com/docs/documentation/platform/gateways/gateway-pools.md) as `gatewayPoolId`.

**Organization-level**

**Step 1**

In the sidebar, select **Integrations**, then open the **App Connections** tab.

![App Connections Tab](https://mintlify.s3.us-west-1.amazonaws.com/infisical/images/app-connections/general/add-connection.png)

**Step 2**

Select **Add Connection** and choose **Coolify**.

**Step 3**

Fill out the form's fields:

* **Name**: A descriptive name for the connection; it must be slug-friendly
* **Description** (optional): A note for future reference
* **Gateway**: The Gateway or Gateway pool to route requests through if your Coolify instance isn't reachable from the internet; otherwise leave it as **Internet Gateway**
* **Method**: **API Token**, the only method the connection supports
* **Instance URL**: `https://app.coolify.io` for Coolify Cloud (filled in by default), or the URL of your self-hosted Coolify dashboard, such as `https://coolify.example.com`
* **Coolify API Token**: The token you copied when [creating a Coolify API token](#step-1-create-a-coolify-api-token)

Then, select **Connect to Coolify**.

**Project-level**

**Step 1**

In your Secrets Management project, select **Integrations** from the sidebar, then open the **App Connections** tab.

**Step 2**

Select **Add Connection** and choose **Coolify**.

**Step 3**

Fill out the form's fields:

* **Name**: A descriptive name for the connection; it must be slug-friendly
* **Description** (optional): A note for future reference
* **Gateway**: The Gateway or Gateway pool to route requests through if your Coolify instance isn't reachable from the internet; otherwise leave it as **Internet Gateway**
* **Method**: **API Token**, the only method the connection supports
* **Instance URL**: `https://app.coolify.io` for Coolify Cloud (filled in by default), or the URL of your self-hosted Coolify dashboard, such as `https://coolify.example.com`
* **Coolify API Token**: The token you copied when [creating a Coolify API token](#step-1-create-a-coolify-api-token)

Then, select **Connect to Coolify**.

When you submit the form, Infisical checks that Coolify accepts the token and that the token has the `write` and `delete` permissions.

> [!TIP]
>
> Your Coolify app connection is ready to use.

## Step 3: Configure integrations

Now that your Coolify app connection is configured, you can use it to set up the following integration:

> [card] [Coolify sync](https://infisical.com/docs/integrations/secret-syncs/coolify.md)
>
> Sync secrets from Infisical to environment variables in Coolify.


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