Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
6 changes: 5 additions & 1 deletion customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -38,16 +38,20 @@
2. Create a new DNS record with the following values:

```text
CNAME | docs | cname.mintlify-dns.com.
CNAME | docs | cname.mintlify.builders
```

<Tip>
Each domain provider has different ways to add DNS records. Refer to your domain provider's documentation for specific instructions.
</Tip>

<Warning>
If you migrate an existing domain and want zero downtime, add the verification `TXT` records before updating your `CNAME`. Then wait until SSL/TLS certificates pre-provision before cutting over. Switching the `CNAME` before certificates are issued causes HTTPS requests to fail until provisioning completes.

Check warning on line 49 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L49

In general, use active voice instead of passive voice ('are issued').
</Warning>

### DNS propagation

DNS changes typically take 1-24 hours to propagate globally, though it can take up to 48 hours in some cases. You can verify your DNS is configured correctly using [DNSChecker](https://dnschecker.org).

Check warning on line 54 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L54

In general, use active voice instead of passive voice ('is configured').

Once your DNS records are active, your documentation is first accessible via HTTP. HTTPS is available after Vercel provisions your TLS certificate.

Expand All @@ -67,13 +71,13 @@

### Reserved paths

The `/.well-known/acme-challenge` path is reserved for certificate validation and cannot be redirected or rewritten. If you have configured redirects or rewrites for this path, certificate provisioning fails.

Check warning on line 74 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L74

In general, use active voice instead of passive voice ('is reserved').

Check warning on line 74 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L74

In general, use active voice instead of passive voice ('be redirected').

### Provider-specific settings

<AccordionGroup>
<Accordion title="Vercel verification">
If Vercel is your domain provider, you must add a verification `TXT` record. This information appears on your dashboard after submitting your custom domain, and is emailed to you.

Check warning on line 80 in customize/custom-domain.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

customize/custom-domain.mdx#L80

In general, use active voice instead of passive voice ('is emailed').
</Accordion>

<Accordion title="Cloudflare encryption mode">
Expand Down
6 changes: 5 additions & 1 deletion es/customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,13 +36,17 @@ Para alojar tu documentación en un dominio personalizado:
2. Crea un nuevo registro DNS con los siguientes valores:

```text
CNAME | docs | cname.mintlify-dns.com.
CNAME | docs | cname.mintlify.builders
```

<Tip>
Cada proveedor de dominios tiene diferentes formas de agregar registros DNS. Consulta la documentación de tu proveedor de dominios para obtener instrucciones específicas.
</Tip>

<Warning>
Si estás migrando un dominio existente y quieres cero tiempo de inactividad, agrega los registros `TXT` de verificación antes de actualizar tu `CNAME` y espera a que los certificados SSL/TLS estén pre-provisionados antes de hacer el cambio. Cambiar el `CNAME` antes de que se emitan los certificados provoca que las solicitudes HTTPS fallen hasta que se complete el aprovisionamiento.
</Warning>


<div id="dns-propagation">
### Propagación de DNS
Expand Down
6 changes: 5 additions & 1 deletion fr/customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,13 +36,17 @@ Pour héberger votre documentation sur un domaine personnalisé :
2. Créez un nouvel enregistrement DNS avec les valeurs suivantes :

```text
CNAME | docs | cname.mintlify-dns.com.
CNAME | docs | cname.mintlify.builders
```

<Tip>
Chaque fournisseur de domaine a des méthodes différentes pour ajouter des enregistrements DNS. Consultez la documentation de votre fournisseur de domaine pour des instructions spécifiques.
</Tip>

<Warning>
Si vous migrez un domaine existant et souhaitez aucun temps d'arrêt, ajoutez les enregistrements `TXT` de vérification avant de mettre à jour votre `CNAME`, puis attendez que les certificats SSL/TLS soient pré-provisionnés avant de basculer. Modifier le `CNAME` avant l'émission des certificats entraîne l'échec des requêtes HTTPS jusqu'à la fin du provisionnement.
</Warning>


<div id="dns-propagation">
### Propagation du DNS
Expand Down
6 changes: 5 additions & 1 deletion zh/customize/custom-domain.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -36,13 +36,17 @@ keywords: ["自定义域名配置", "DNS 配置", "CNAME 记录", "TLS 证书"]
2. 新建一条 DNS 记录,并按以下值进行设置:

```text
CNAME | docs | cname.mintlify-dns.com.
CNAME | docs | cname.mintlify.builders
```

<Tip>
不同域名提供商添加 DNS(域名系统)记录的方式各不相同。请查阅你的域名提供商文档获取具体操作指南。
</Tip>

<Warning>
如果你正在迁移现有域名并希望实现零停机,请先添加验证用的 `TXT` 记录,再更新 `CNAME`,并等待 SSL/TLS 证书预配置完成后再进行切换。如果在证书签发之前就更改 `CNAME`,HTTPS 请求将会失败,直到证书配置完成。
</Warning>


<div id="dns-propagation">
### DNS 传播
Expand Down
Loading