Skip to content

Clarify Cloudflare DNS setup for custom domains - #36

Draft
qayshp wants to merge 2 commits into
BlueBubblesApp:masterfrom
qayshp:agent/clarify-cloudflare-dns-setup
Draft

Clarify Cloudflare DNS setup for custom domains#36
qayshp wants to merge 2 commits into
BlueBubblesApp:masterfrom
qayshp:agent/clarify-cloudflare-dns-setup

Conversation

@qayshp

@qayshp qayshp commented Jul 23, 2026

Copy link
Copy Markdown

Summary

  • clarify that Cloudflare needs the root domain while BlueBubbles can use a subdomain
  • replace the missing “records below” instruction with a DNS migration checklist
  • explain that a public hostname normally creates its tunnel CNAME automatically
  • document the complete <tunnel-UUID>.cfargotunnel.com target for the manual fallback

Why

The guide told readers to copy records that were never listed, which could leave existing websites or email records behind during the nameserver change. It also told readers to use a bare tunnel ID as a CNAME target even though Cloudflare Tunnel targets use the cfargotunnel.com hostname.

User impact

Readers can move an existing domain to Cloudflare without silently dropping unrelated DNS services, and they can confidently use a dedicated BlueBubbles subdomain.

Checks

  • git diff --check
  • confirmed the obsolete “records below” and bare tunnel-ID instructions are gone
  • compared the public-hostname behavior and CNAME target with Cloudflare's current Tunnel routing documentation

Fixes #25

@qayshp qayshp left a comment

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Self-review: the broken DNS migration instruction is fixed, with one wording edge case to address before this is ready.

Comment thread server/advanced/byo-proxy-service-guides/cloudflare-with-a-custom-domain.md Outdated
@qayshp

qayshp commented Jul 23, 2026

Copy link
Copy Markdown
Author

Validation update

  • git diff --check origin/master...HEAD passes.
  • Current Cloudflare documentation confirms that a tunnel receives a <UUID>.cfargotunnel.com hostname and that the public hostname uses a CNAME pointed at that full target.
  • The obsolete “records below” wording and bare tunnel-ID target are absent from the updated guide.

A live Cloudflare dashboard/tunnel test was not performed, so this pass does not independently verify the dashboard's current automatic DNS-record creation behavior.

@qayshp
qayshp marked this pull request as ready for review July 28, 2026 07:02
@qayshp
qayshp marked this pull request as draft July 28, 2026 07:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

"Cloudflare with a custom domain" guide missing information

1 participant