Dominios personalizados

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

Resumen de la configuración

Opciones de alojamiento

Al agregar un dominio, elige tu modo de alojamiento:

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.

Alojar en /docs (basado en proxy, subruta personalizable)

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

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

/docs es el valor predeterminado; puedes elegir cualquier otra subruta de un solo segmento (/help, /guide, etc.) desde el mismo interruptor. Configuras un proxy (Cloudflare, Vercel, nginx, etc.) para reenviar las solicitudes de tu subruta elegida a Jamdesk. Consulta Alojamiento por subruta para ver guías de configuración y las reglas para elegir una subruta.

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 "Nombre" es solo la parte del subdominio. Para docs.example.com, ingresa docs.

Dominios apex (por ejemplo, example.com)

Los dominios apex usan un registro A en lugar de un 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 (registro CNAME o A, más TXT)
2. Verifica la propiedad del dominio mediante el registro TXT
3. Provisiona un certificado SSL mediante Let's Encrypt
4. Enruta el tráfico hacia tu documentación

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

• Pending (pendiente) - Esperando la propagación del DNS
• Active (activo) - Dominio verificado y sirviendo tráfico
• Needs Attention (requiere atención) - Configuración incorrecta o conflicto (revisa la notificación por correo electrónico)
• Error (error) - Problema de configuración (ver detalles en el dashboard)

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

Certificados SSL

Los certificados SSL se provisionan automáticamente y se renuevan antes de su vencimiento. 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 dominio 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 siendo accesible en el subdominio *.jamdesk.app

Usuarios de Cloudflare

Si usas Cloudflare como tu proveedor de DNS:

1. Configura el estado del proxy en DNS only (icono 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 los docs
3. Una vez que finalice la verificación, puedes volver a habilitar 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 que se sirven 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?