> This page is for 文档.

> For clean Markdown content of this page, append .md to this URL. For the complete documentation index, see https://buildwithfern.com/learn/llms.txt.

# Move your custom domain off Vercel

> Fern Docs has moved to new hosting. Point custom domains that still resolve to Vercel at cname.ferndocs.com before December 1, 2026, when publishing to them starts failing.

Fern Docs sites are [prebuilt as static pages](https://buildwithfern.com/post/static-docs) and served from the edge, meaning:

* Pages load faster.
* A publish no longer slows your site down.
* Every page is served with a stricter security policy.

Fern Docs hosting has moved from Vercel to Cloudflare.

> **Error**
>
> All domains must point to `cname.ferndocs.com` by **December 1, 2026**. From that date, `fern generate --docs` fails for any domain that still points to Vercel. Your docs stay live on the current setup until you change the DNS record, so the switch causes no downtime.

## Who's affected

A domain needs to move if its DNS has either of these records:

* A CNAME record to a `vercel-dns.com` host, such as `cname.vercel-dns.com` or `b7278b3c9357963d.vercel-dns-013.com`.
* For a root domain, an `A` record to a Vercel IP address, such as `76.76.21.21`.

Subpath domains (`mydomain.com/docs`) and domains served through a [reverse proxy](/learn/docs/preview-publish/reverse-proxy) or your own CDN aren't affected.

To check a domain, look up its DNS records:

```bash
dig +short CNAME docs.mydomain.com
dig +short A mydomain.com
```

## Make the switch

An [admin](/learn/dashboard/configuration/permissions) of your Fern organization needs to complete these steps.

#### Start the switch

Open the [Fern Dashboard](https://dashboard.buildwithfern.com/), select your docs site, and select **Make the switch**. If you started earlier and didn't finish, the button reads **Finish the switch**.

#### Verify domain ownership

Add the TXT records the Dashboard shows to your DNS provider: one for domain ownership and one for the SSL certificate. The certificate record appears after ownership is verified. Then select **Verify TXT records**.

Provider guides for TXT records: [Cloudflare](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/), [GoDaddy](https://www.godaddy.com/help/add-a-txt-record-19232), [Namecheap](https://www.namecheap.com/support/knowledgebase/article.aspx/317/2237/how-do-i-add-txtspfdkimdmarc-records-for-my-domain/), [Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-creating.html).

#### Update your CNAME record

Change your domain's CNAME record to `cname.ferndocs.com`. For a root domain, use an `ALIAS` record or a flattened CNAME pointing to `cname.ferndocs.com`. Return to the Dashboard to confirm the DNS change.

```
CNAME   docs    cname.ferndocs.com
```

Provider guides for CNAME records: [Cloudflare](https://developers.cloudflare.com/dns/manage-dns-records/how-to/create-dns-records/), [GoDaddy](https://www.godaddy.com/help/add-a-cname-record-19236), [Namecheap](https://www.namecheap.com/support/knowledgebase/article.aspx/9646/2237/how-to-create-a-cname-record-for-your-domain/), [Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-creating.html). On Cloudflare, set the record's [proxy status](https://developers.cloudflare.com/dns/proxy-status/) to **DNS only**.

After the DNS change propagates, your site is served from Fern's new hosting and `fern generate --docs` stops warning about the domain. For general DNS setup, see [Set up a custom domain](/learn/dashboard/configuration/custom-domains).

For help, reach out in your Fern Slack channel or email [support@buildwithfern.com](mailto:support@buildwithfern.com).