Integration
This guide will show you how to use Bitbucket based repositories with Coolify.
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://bitbucket.com/coolify-test2/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 Bitbucket repository in theRepository Settings
/Access 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@bitbucket.org:coolify-test2/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 Bitbucket 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 Bitbucket repository.
- Set a secret key in the
Bitbucket Webhook Secret
input field. - Go to your repository in Bitbucket and open the
Repository Settings
/Webhooks
menu asRepository hooks
. - Add the URL from Coolify to the
URL
input field and the secret token. - Select the
Push
option. - That’s it! Now when you push to your repository, Bitbucket 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 Bitbucket repository to trigger a new deployment when you create a new merge request.
The process is the same as the previous one. In the Repository Settings
/ Webhooks
menu, you need to select the following events in the Pull Request
option:
Created
Updated
Merged
Declined