Dominios personalizados

Sirve tu documentación desde tu propio dominio en lugar del subdominio *.jamdesk.app predeterminado.

Resumen de la configuración

Opciones de hospedaje

Al agregar un dominio, elige tu modo de hospedaje:

Dominio estándar

Tu documentación se sirve directamente desde Jamdesk en tu dominio personalizado:

docs.example.com → acme.jamdesk.app

El DNS apunta a Jamdesk, y los certificados SSL se gestionan automáticamente.

Hospedar en /docs (basado en proxy)

Tu documentación se sirve en una subruta de tu sitio web existente:

example.com/docs → acme.jamdesk.app/docs

Configuras un proxy (Cloudflare, Vercel, nginx, etc.) para reenviar las solicitudes de /docs/* a Jamdesk. Consulta Hospedaje en subruta para guías de configuración.

Configuración de DNS

Los registros que necesitas dependen de si usas un subdominio o un dominio apex (raíz).

Subdominios (por ejemplo, docs.example.com)

El campo "Name" es solo la parte del subdominio. Para docs.example.com, introduce docs.

Dominios apex (por ejemplo, example.com)

Los dominios apex usan un registro A en lugar de CNAME porque los estándares DNS (RFC 1034) prohíben los registros CNAME en el apex de la zona.

Verificación

Después de agregar los registros DNS, Jamdesk automáticamente:

1. Detecta tus registros DNS (CNAME o registro A, más TXT)
2. Verifica la propiedad del dominio mediante el registro TXT
3. Aprovisiona un certificado SSL mediante Let's Encrypt
4. Enruta el tráfico hacia tu documentación

Consulta el estado de verificación en Settings → Domain. El estado se muestra como:

• Pending - Esperando la propagación del DNS
• Active - Dominio verificado y sirviendo tráfico
• Needs Attention - Discrepancia o conflicto de configuración (revisa la notificación por correo)
• Error - Problema de configuración (ver detalles en el dashboard)

Haz clic en Refresh en el dashboard para comprobar manualmente el estado de verificación.

Certificados SSL

Los certificados SSL se aprovisionan automáticamente y se renuevan antes de vencer. HTTPS es obligatorio, por lo que las solicitudes HTTP se redirigen a HTTPS.

No necesitas configurar los certificados manualmente.

Dominios raíz

Los dominios raíz (apex) como example.com son totalmente compatibles. El dashboard muestra automáticamente los registros correctos: un registro A que apunta a 76.76.21.21 en lugar de un CNAME, ya que los estándares DNS prohíben los registros CNAME en el apex de la zona.

Si prefieres un subdominio como docs.example.com, eso también funciona.

Múltiples dominios

Cada proyecto admite un dominio personalizado. Para varios dominios que apunten a la misma documentación:

1. Configura tu dominio principal en Jamdesk
2. Configura los dominios adicionales para que redirijan al principal a nivel de DNS/CDN

Eliminar un dominio

Para desconectar un dominio personalizado:

1. Ve a Settings → Domain
2. Haz clic en Remove Domain
3. Tu documentación sigue accesible en el subdominio *.jamdesk.app

Usuarios de Cloudflare

Si usas Cloudflare como tu proveedor de DNS:

1. Establece el estado del proxy en DNS only (ícono de nube gris) durante la verificación del dominio
2. Deja que Vercel gestione el SSL: desactiva "Always Use HTTPS" de Cloudflare para el subdominio de la documentación
3. Después de completar la verificación, puedes volver a activar el proxy (nube naranja)

Solución de problemas

Verificar el DNS con dig

# Check CNAME record (subdomains)
dig CNAME docs.example.com

# Check A record (apex domains)
dig A example.com

# Check TXT record
dig TXT _jamdesk.example.com

Para diagnósticos detallados, consulta Problemas de DNS.

¿El subdominio jamdesk.app compite con mi dominio en las búsquedas?

No. Una vez que tu dominio personalizado está activo, las páginas servidas directamente desde tu subdominio [slug].jamdesk.app incluyen un enlace canónico que apunta a tu dominio, por lo que los motores de búsqueda tratan tu dominio como la única fuente de verdad y consolidan allí todas las señales de posicionamiento.

¿Qué sigue?