Coolify icon

Coolify

Interact with Coolify API

Overview

This node integrates with the Coolify API to manage applications and other related resources. Specifically, the "Application" resource with the "Create (Public)" operation allows users to create a new public application deployment on a selected server and project within Coolify. This is useful for automating deployment workflows where you want to programmatically spin up applications from git repositories.

Typical use cases include:

  • Automatically deploying a public application from a specified git repository branch.
  • Integrating deployment steps into CI/CD pipelines.
  • Managing multiple applications across different servers and projects without manual intervention.

For example, you can configure this node to deploy a web app by specifying the target server, project, repository URL, and branch, enabling seamless continuous deployment triggered by n8n workflows.

Properties

Name Meaning
Server Name or ID Select the target server by name or ID where the application will be deployed.
Project Name or ID Select the project under which the application will be created.
Name The name of the new application to be created.
Repository URL The URL of the git repository containing the application's source code.
Branch The git branch to deploy from; defaults to "main".

Output

The node outputs an array of JSON objects representing the response from the Coolify API after creating the application. Each object contains details about the newly created application, such as its ID, status, configuration, and metadata returned by the API.

No binary data output is indicated in the source code.

Dependencies

  • Requires an active connection to the Coolify API via an API key credential configured in n8n.
  • The node uses internal helper functions to make authenticated HTTP requests to Coolify endpoints.
  • The node dynamically loads options for servers and projects from the Coolify API to populate dropdowns.

Troubleshooting

  • Common issues:
    • Failure to load server or project options may indicate connectivity issues or invalid API credentials.
    • Errors during creation often stem from missing required parameters or invalid repository URLs.
  • Error messages:
    • "The resource \"application\" is not implemented!" — indicates a misconfiguration or unsupported resource selection.
    • "The operation \"createPublic\" is not implemented!" — suggests the operation name might be incorrect or not supported.
  • Resolutions:
    • Verify that the API key credential is correctly set and has sufficient permissions.
    • Ensure all required fields are provided and valid.
    • Confirm that the repository URL and branch exist and are accessible.

Links and References

Discussion