Dokploy / Dokploy/dokploy

[Feature] Native Cloudflare Tunnel integration for domain publishing

Open
#4,309 2 comments 8 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
37.4k
Forks
3k
Avg merge
1d 3h
Merged PRs (30d)
73

Description

What problem will this feature address?

Currently, setting up Cloudflare Tunnel with Dokploy requires manual
steps: deploying cloudflared separately, configuring Traefik, managing
DNS records by hand. Many users struggle with this:

  • #966 — Users asking how to set up CF Tunnel with Dokploy
  • #2153 — 502 errors after hours of manual setup attempts
  • #3472 — Mixed content issues due to incorrect tunnel configuration
Describe the solution you'd like

Cloudflare integration with three runtime modes:

1. Use Existing Tunnel Instance
Routes new domains through an already-running tunnel via CF API.
No new containers needed.

2. Dokploy Managed Shared Connector
Dokploy deploys and manages a single shared cloudflared container.
Multiple domains share one connector.

3. Start Cloudflared Sidecar
Each service gets its own isolated cloudflared container.

Describe alternatives you've considered

The current workaround is manually deploying cloudflared as a separate
Docker service and configuring Traefik + DNS by hand, as documented in
Dokploy's own guide. This works but requires significant manual effort
and leaves room for misconfiguration (SSL loops, 502 errors, mixed
content issues — as seen in linked issues).

Additional context

Working implementation available at https://github.com/bkbalci/dokploy/tree/feature/cloudflare-tunnel, happy to open a draft PR.

Domain popup:
Image

Domain status (shared connector) :
Image

Domain status (sidecar) :
Image

Cloudflare settings page :
Image

Cloudflare settings page shared connectors :
Image

Will you send a PR to implement it?

Yes

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the feature/cloudflare-tunnel branch and Dokploy's existing Cloudflare guide, then trace the Cloudflare API, Traefik, and Docker service entry points involved. Done means a documented, tested integration supporting existing tunnels, a Dokploy-managed shared connector, and per-service cloudflared sidecars without the listed routing or SSL issues.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, typescript
Domain
cloud, devops, networking
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.