Coolify

System monitoringDeployment

Self-hosted PaaS and deployment platform

Widgets & Capabilities

CoolifyOverview of your Coolify instance with servers, applications, and services.

Details

Adding the integration

You can find how to add the integration on the Integrations Management documentation page.

URL configuration

Use the root URL of your Coolify instance, for example https://coolify.example.com. Homarr calls Coolify endpoints under /api and /api/v1 automatically.

Secrets

API Key

Name	Description
API Key	API Key from the service for authentication.

Steps to retrieve the credentials:

1. Open your Coolify instance and make sure you are in the team you want Homarr to monitor.
2. Enable API access under Settings > Advanced if it is disabled.
3. Go to Security > API Tokens.
4. Enter a name, e.g. "Homarr".
5. Select the read permission. The Coolify widget only reads version, server, project, application, and service data.
6. Click "Create".
7. Copy the generated token immediately. Coolify only shows it once.
8. Paste the token into the API Key field in Homarr.