Skip to content

docs(dns): require Direct CNAME for custom domains (no orange-cloud) - #19

Merged
echobt merged 1 commit into
mainfrom
droid/ec699691-docs-direct-cname-not-orange
Sep 15, 2026
Merged

echobt merged 1 commit into
mainfrom
droid/ec699691-docs-direct-cname-not-orange

Conversation

@echobt

@echobt echobt commented Sep 15, 2026

Copy link
Copy Markdown
Contributor

Summary

Operator docs in this repository now state that every Cortex custom domain
that CNAMEs to a third-party hostname uses a Direct CNAME (DNS only).

  • README.md gains a Custom-domain DNS section listing the affected
    names: docs.cortex.foundation (Mintlify), status.cortex.foundation
    (status page), the FernDesk Connect domain, and the
    software.cortex.foundation / releases.cortex.foundation R2 custom
    domains owned by CortexLM/backend.
  • scripts/FERNDESK.md repeats the rule where the FernDesk Connect domain
    is described, and points back at the README.

Why

A Proxied (orange-cloud) CNAME to a hostname that belongs to another
Cloudflare customer triggers Cloudflare Cross-User Banned (Error 1014)
and the hostname stops serving. Nothing in these docs said which side of the
toggle to pick, so an operator following them could pick Proxied.

Explicit wording added:

Use a Direct CNAME (DNS only). Do not enable orange-cloud Proxied
that causes Cloudflare Cross-User Banned (Error 1014).

Test plan

node scripts/check-docs-site.mjs          # ok (24 problem pages)
bash scripts/tests/check-docs-site.test.sh # ok
python3 scripts/tests/ferndesk-sync-retry.test.py # ok
npm exec --yes --package=mint@4.2.876 -- mint validate  # build validation passed

No navigation, chrome, or public MDX page changed; both files are
repository/operator docs, not Mintlify pages.

A Proxied (orange-cloud) CNAME to another Cloudflare customer's hostname
triggers Cloudflare Cross-User Banned (Error 1014). Spell out Direct
CNAME (DNS only) for docs.cortex.foundation (Mintlify),
status.cortex.foundation, the FernDesk Connect domain, and the
software./releases. R2 custom domains owned by CortexLM/backend.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@mintlify

mintlify Bot commented Sep 15, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
cortex-foundation-add13747 🟢 Ready View Preview Sep 15, 2026, 6:51 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@echobt

echobt commented Sep 15, 2026

Copy link
Copy Markdown
Contributor Author

@greptileai review

@echobt
echobt merged commit 561fb90 into main Sep 15, 2026
5 checks passed
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.

1 participant