Integration
Public Repositories
You can use public repositories without any additional setup.
- Select the
Public repository
option in the Coolify when you create a new resource. - Add your repository URL to the input field, for example:
https://gitlab.com/andrasbacsai/coolify-examples
- That’s it! Coolify will automatically pull the latest version of your repository and deploy it.
Private Repositories
Private repositories require a few more steps to setup.
- Add a private key (aka
Deploy Keys
) to Coolify and to your GitLab repository in theSettings
/Repository
/Deploy Keys
menu.
- Create a new resource and select the
Private Repository (with deploy key)
- Add your repository URL to the input field, for example:
git@gitlab.com:andrasbacsai/coolify-examples.git
- That’s it! Coolify will automatically pull the latest version of your repository and deploy it.
Automatic commit deployments with webhooks (Optional)
You can add a custom webhook URL to your GitLab repository to trigger a new deployment when you push to your repository.
In your resource, there is a Webhooks
menu. In the Manual Git Webhooks
section, you can find the URL what you need to set in your GitLab repository.
- Set a secret key in the
GitLab Webhook Secret
input field. - Go to your repository in GitLab and open the
Settings
/Webhooks
menu. - Add the URL from Coolify to the
URL
input field and the secret token. - Select the
Push events
option. - That’s it! Now when you push to your repository, GitLab will send a webhook request to Coolify and it will trigger a new deployment.
Merge request deployments with webhooks (Optional)
You can add a custom webhook URL to your GitLab repository to trigger a new deployment when you create a new merge request.
The process is the same as the previous one, but you need to select the Merge request events
option in the Settings
/ Webhooks
menu.