Preview Deployment is not triggering the pull request

[BrunoMoraes-Z]

I configured a microservice in a repository on GitHub. In the settings, I enabled preview deployment and configured the Wildcard Domain as: auth-${uniqueId}-dev.example.com

[Bartuniooo]

It looks like you’ve configured a preview deployment with a wildcard domain, but the deployment isn’t triggering when a PR is opened.

🔍 What might be going wrong

Preview Deployments require correct webhook setup
Make sure that in your GitHub repository settings, the Dokploy webhook is configured properly — Dokploy listens for PR events via webhook to trigger preview deploys. If the webhook isn’t added or is misconfigured, the PR won’t trigger anything.

Check that the webhook events include “Pull Request” events
In the GitHub webhook settings, ensure that “Pull requests” (or “Send me everything”) is selected. Dokploy needs that event to start a preview deployment.

Wildcard domains must match and be routable
If you’re using a wildcard domain (e.g. auth-${uniqueId}-dev.example.com), confirm:

Your DNS wildcard record (*.example.com) is pointing correctly to your Dokploy instance.

The wildcard domain configuration in Dokploy matches the pattern you’re generating for preview URLs.

Verify logs and webhook deliveries

Check the GitHub webhook delivery logs (in the repository → Settings → Webhooks) to see if GitHub is sending the event and whether it’s returning a success (2xx) response.

Check Dokploy logs to see if the webhook request even arrives or if there are errors.

Dokploy version matters
Some older versions had issues with preview deployments interacting with webhooks. Make sure you’re running a recent release where preview deployments are supported stably.

🛠 Quick steps to debug

Open your GitHub repo → Settings → Webhooks
→ Check the Dokploy webhook
→ Confirm Pull Request events are enabled.

Trigger a test webhook manually (you can use GitHub’s “Redeliver” on past events) and check Dokploy logs.

Double-check DNS and wildcard domain settings — if DNS isn’t resolving to Dokploy, the preview deployment won’t be reachable even if created.