Coolify Docs

GitHub Actions ​

You can use GitHub Actions to build your image and deploy it to Coolify.

Here is an example repository and a workflow file that you can check how it works.

Process Overview ​

  1. You need to create a GitHub Action workflow file in your repository.

  2. You need to build your image and push it to a Docker registry. In the example, I use ghcr.io, but you can use any other registry.

  3. You need to create a Coolify API Token and add it to your GitHub repository secrets.

    • COOLIFY_TOKEN in the example.

  4. In Coolify, you need to setup your deployment type. It could be a simple Dockerfile, Docker Compose or Docker Image based deployment.

  5. Get the proper webhook endpoint from Coolify (Your resource / Webhook menu) and add it to your GitHub repository secrets.

    • COOLIFY_WEBHOOK in the example.

  6. Need to send a GET request to that webhook endpoint (authenticated with the token) to trigger the deployment

    bash
    curl --request GET "${% raw %}{{ secrets.COOLIFY_WEBHOOK }}{% endraw %}" --header "Authorization: Bearer ${% raw %}{{ secrets.COOLIFY_TOKEN }}{% endraw %}"

  7. That's it! Now you can push to your repository and the deployment will be triggered automatically.