# Gitea → Dokploy Webhook Setup

Steps to configure the Gitea repository webhook to trigger Dokploy compose deployments:

1. In Gitea, open the repository and go to **Settings → Webhooks**.
2. Click **Add Webhook** and choose **Gitea** or **Custom** depending on your Gitea version.
3. Fill in the endpoint URL: `https://system.cloudarix.de/api/deploy/compose/JXSdfeHdc6wBKUEiJrX_9`.
4. Set **Content Type** to `application/json`.
5. (Optional but recommended) Add a secret token for payload signing. Store the secret in Dokploy project-level secrets and enable signature validation in Dokploy if supported.
6. Select events: enable **Push events** (and tag push if you want tag-triggered deploys).
7. Leave SSL verification enabled unless Dokploy uses a self-signed cert (then configure accordingly).
8. Save the webhook and use the **Test Delivery** function to send a sample payload.

Verification
- A successful delivery should return HTTP 2xx from Dokploy. Verify a deployment run appears in Dokploy and that the `commit_sha` from the payload is recorded in the run.

Troubleshooting
- If Dokploy returns 4xx, check webhook secret/signature and Dokploy project authentication.
- If Dokploy cannot clone the repo, ensure `REPO_DEPLOY_KEY` is configured and has read access.
