Jamdesk Documentation logo

Sottodomini Jamdesk

Il tuo sottodominio predefinito yourproject.jamdesk.app: regole di denominazione, come modificarlo e quando passare a un dominio personalizzato.

Ogni progetto Jamdesk riceve un sottodominio gratuito all'indirizzo yourproject.jamdesk.app. Questo è l'URL predefinito della documentazione e funziona subito dopo il primo deploy.

Come funzionano i sottodomini

Quando crei un progetto, Jamdesk assegna automaticamente un sottodominio basato sullo slug del progetto:

Slug del progettoSottodominio
my-docsmy-docs.jamdesk.app
acme-apiacme-api.jamdesk.app
company-helpcompany-help.jamdesk.app

Il sottodominio diventa attivo non appena viene completato il primo build.

Regole per i nomi dei sottodomini

I sottodomini devono rispettare queste regole:

  • Solo lettere minuscole, numeri e trattini
  • Devono iniziare con una lettera
  • Non possono iniziare o terminare con un trattino
  • Devono contenere da 3 a 63 caratteri
  • Devono essere univoci tra tutti i progetti Jamdesk

Modificare il sottodominio

Per modificare il sottodominio:

  1. Vai al tuo progetto nel Dashboard
  2. Apri SettingsGeneral
  3. Aggiorna il campo Project Slug
  4. Fai clic su Save

La modifica del sottodominio interrompe i link esistenti. I motori di ricerca e i siti esterni che rimandano al vecchio sottodominio restituiranno errori 404. Se hai bisogno di mantenere stabili gli URL, valuta invece la configurazione di un dominio personalizzato.

Dopo la modifica:

  • Il nuovo sottodominio è attivo immediatamente
  • Il vecchio sottodominio restituisce 404
  • I segnalibri e i link esterni smettono di funzionare
  • Il posizionamento nei motori di ricerca viene azzerato

Certificati SSL

I certificati SSL vengono forniti automaticamente per tutti i sottodomini *.jamdesk.app. HTTPS è obbligatorio; le richieste HTTP vengono reindirizzate a HTTPS.

Limiti di frequenza

I sottodomini Jamdesk condividono l'infrastruttura con altri progetti. Per la documentazione ad alto traffico:

  • Valuta un dominio personalizzato per ottenere risorse dedicate
  • Contatta il supporto se prevedi un traffico elevato e costante

Quando usare un dominio personalizzato

Usa un dominio personalizzato quando:

  • Hai bisogno di URL stabili (le modifiche al sottodominio interrompono i link)
  • Vuoi pubblicare la documentazione all'indirizzo docs.yourcompany.com
  • Devi utilizzare il dominio della tua azienda
  • La documentazione è destinata ai clienti

Consulta Domini personalizzati per le istruzioni di configurazione.

Sottodominio o dominio personalizzato

FunzionalitàSottodominioDominio personalizzato
Tempo di configurazioneImmediato10-30 minuti
CostoGratuitoGratuito (devi fornire il dominio)
Formato URLproject.jamdesk.appdocs.yourdomain.com
SSLAutomaticoAutomatico
BrandingCon il branding JamdeskIl tuo branding
Stabilità dell'URLLegata allo slug del progettoPermanente

E adesso?

Domini personalizzati

Configura docs.yourdomain.com

Risoluzione problemi DNS

Risolvi i problemi di configurazione del dominio