Subdominios de Jamdesk
Tu subdominio predeterminado yourproject.jamdesk.app -- reglas de nomenclatura, cómo cambiarlo y cuándo cambiar a un dominio personalizado.
Cada proyecto de Jamdesk obtiene un subdominio gratuito en yourproject.jamdesk.app. Esta es tu URL de documentación predeterminada y funciona de inmediato después de tu primer despliegue.
Cómo funcionan los subdominios
Cuando creas un proyecto, Jamdesk asigna automáticamente un subdominio basado en el slug de tu proyecto:
| Slug del proyecto | Subdominio |
|---|---|
my-docs | my-docs.jamdesk.app |
acme-api | acme-api.jamdesk.app |
company-help | company-help.jamdesk.app |
Tu subdominio estará activo en cuanto se complete tu primer build.
Reglas de nomenclatura de subdominios
Los subdominios deben seguir estas reglas:
- Solo letras minúsculas, números y guiones
- Debe comenzar con una letra
- No puede comenzar ni terminar con un guión
- Entre 3 y 63 caracteres de longitud
- Debe ser único entre todos los proyectos de Jamdesk
Cambiar tu subdominio
Para cambiar tu subdominio:
- Ve a tu proyecto en el dashboard
- Abre Settings → General
- Actualiza el campo Project Slug
- Haz clic en Save
Cambiar tu subdominio rompe los enlaces existentes. Los motores de búsqueda y los sitios externos que enlazan a tu subdominio anterior recibirán errores 404. Considera configurar un dominio personalizado en su lugar si necesitas estabilidad en las URL.
Después del cambio:
- Tu nuevo subdominio estará activo de inmediato
- El subdominio anterior devuelve 404
- Los marcadores y los enlaces externos dejarán de funcionar
- Las posiciones en los motores de búsqueda se reinician
Certificados SSL
Los certificados SSL se aprovisionan automáticamente para todos los subdominios *.jamdesk.app. HTTPS es obligatorio: las solicitudes HTTP redirigen a HTTPS.
Límites de velocidad
Los subdominios de Jamdesk comparten infraestructura con otros proyectos. Para documentación con mucho tráfico:
- Considera un dominio personalizado para recursos dedicados
- Contacta con soporte si esperas tráfico alto sostenido
Cuándo usar un dominio personalizado
Usa un dominio personalizado cuando:
- Necesites estabilidad en las URL (los cambios de subdominio rompen los enlaces)
- Quieras tu documentación en
docs.yourcompany.com - Necesites coincidir con el dominio de tu empresa
- Tu documentación esté orientada al cliente
Consulta Dominios personalizados para obtener instrucciones de configuración.
Subdominio vs. dominio personalizado
| Característica | Subdominio | Dominio personalizado |
|---|---|---|
| Tiempo de configuración | Inmediato | 10-30 minutos |
| Coste | Gratuito | Gratuito (tú aportas el dominio) |
| Formato de URL | project.jamdesk.app | docs.yourdomain.com |
| SSL | Automático | Automático |
| Marca | Marca Jamdesk | Tu marca |
| Estabilidad de URL | Vinculada al slug del proyecto | Permanente |
