Subdominios de Jamdesk
Tu subdominio predeterminado yourproject.jamdesk.app: reglas de nombres, cómo cambiarlo y cuándo usar 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 inmediatamente después de tu primer deployment.
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 está activo tan pronto como se completa tu primer build.
Reglas de nombres 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 guion
- Entre 3 y 63 caracteres
- 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 sitios externos que enlacen a tu subdominio anterior recibirán errores 404. Considera configurar un dominio personalizado en su lugar si necesitas estabilidad de URL.
Después de cambiar:
- Tu nuevo subdominio está activo de inmediato
- El subdominio anterior devuelve 404
- Los marcadores y enlaces externos se rompen
- El posicionamiento en motores de búsqueda se reinicia
Certificados SSL
Los certificados SSL se aprovisionan automáticamente para todos los subdominios *.jamdesk.app. HTTPS es obligatorio; las solicitudes HTTP se redirigen a HTTPS.
Límites de tasa
Los subdominios de Jamdesk comparten infraestructura con otros proyectos. Para documentación de alto tráfico:
- Considera un dominio personalizado para recursos dedicados
- Contacta al soporte si esperas tráfico alto sostenido
Cuándo usar un dominio personalizado
Usa un dominio personalizado cuando:
- Necesitas estabilidad de URL (los cambios de subdominio rompen enlaces)
- Quieres que tus docs estén en
docs.yourcompany.com - Necesitas que coincida con el dominio de tu empresa
- Tu documentación está orientada a clientes
Consulta Dominios personalizados para instrucciones de configuración.
Subdominio vs. dominio personalizado
| Característica | Subdominio | Dominio personalizado |
|---|---|---|
| Tiempo de configuración | Instantáneo | 10-30 minutos |
| Costo | Gratis | Gratis (tú provees el dominio) |
| Formato de URL | project.jamdesk.app | docs.yourdomain.com |
| SSL | Automático | Automático |
| Branding | Marca Jamdesk | Tu marca |
| Estabilidad de URL | Vinculada al slug del proyecto | Permanente |
