Skip to main content
A Coolify connection authenticates Infisical to Coolify Cloud or your self-hosted Coolify instance with an API token, so Infisical can list your applications, services, and databases and manage their environment variables.
This guide only authenticates Infisical with Coolify. Once the app connection is ready, you can use it to set up 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 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.
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.
2
In the sidebar, select Keys & Tokens, then API Tokens, and select New token.
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.
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.
To create the connection using the API, use the Coolify Create 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 as gatewayPoolId.
1
In the sidebar, select Integrations, then open the App Connections tab.App Connections Tab
2
Select Add Connection and choose Coolify.
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
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.
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:

Coolify sync

Sync secrets from Infisical to environment variables in Coolify.