> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tester.army/integrations/llms.txt.
> For full documentation content, see https://docs.tester.army/integrations/llms-full.txt.

# Coolify

Coolify deployments are detected via a webhook you configure in Coolify's notification settings. Results are posted as GitHub PR comments.

## Setup

1. Go to **Project → Settings → CI/CD** and select **Coolify**.
2. Click **Add Webhook** and copy the generated URL.
3. In Coolify: [**Notifications → Webhook**](https://coolify.io/docs/knowledge-base/notifications) - paste the URL and enable deployment events.

TesterArmy uses `pull_request_id` from the Coolify payload to identify the PR.

## Docker Compose workaround

Coolify has a [known issue](https://github.com/coollabsio/coolify/issues/8958) 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:

```
https://{{pr_number}}.myapp.com
```

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 installation in Project Settings.
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**.