Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
echobt merged 1 commit into from
Sep 15, 2026
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,19 @@ Requires Node 20.17+. The site is intended to publish at
step in the Mintlify dashboard. Connect `CortexLM/docs`, branch `main`, with
the content directory set to the repository root (not `apps/docs`).

### Custom-domain DNS

Every Cortex custom domain that CNAMEs to a third-party hostname is a
**Direct CNAME (DNS only)** — `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`](https://github.com/CortexLM/backend)
(`docs/software-cdn.md`).

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

## Checks

```bash
Expand Down
5 changes: 5 additions & 0 deletions scripts/FERNDESK.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,3 +84,8 @@ backoff). Local runs fall back to urllib only if `curl_cffi` is not installed.

Separately: the FernDesk UI still needs **Connect domain** for `docs.cortex.foundation`
HTTPS. That custom-domain 403 is unrelated to CF 1010 on `api.ferndesk.com`.

When that record goes in, use a **Direct CNAME (DNS only)** — **do not enable
orange-cloud Proxied**; that causes Cloudflare **Cross-User Banned** (Error 1014).
The same rule holds for every other Cortex custom domain that CNAMEs to a
third-party host: [`README.md`](../README.md#custom-domain-dns).
Loading