Skip to main content
Coolify deployments are detected via a webhook you configure in Coolify’s notification settings. Connect GitHub and enable PR testing first so TesterArmy can resolve the pull request and report results.

​
Setup

  1. In TesterArmy, open your project → Integrations → Coolify and click Add Webhook. Copy the generated URL - it contains the secret and won’t be shown again.
  2. In Coolify: Notifications → Webhook - paste the URL and enable deployment events.
TesterArmy matches preview deployments to their pull request automatically.

​
Docker Compose workaround

Coolify has a known issue where Docker Compose deployments don’t send the preview URL. Other build packs (Nixpacks, Dockerfile, Static) work out of the box. Workaround: set a Preview URL pattern when creating the webhook:
TesterArmy substitutes the PR number from the payload to build the URL.

​
Troubleshooting

​
Missing deployment URL

Webhook payload does not contain a deployment URL
  • Docker Compose - configure a Preview URL pattern (see above).
  • No domain configured - your app needs a domain set in Coolify.

​
No PR comment appears

  1. GitHub App not connected - verify the installation under Integrations → GitHub.
  2. Missing PR number - Coolify only sends pull_request_id for preview deployments, not production.
  3. Permissions - the GitHub App needs Pull requests: Read & Write.