Domini personalizzati

Servi la documentazione dal tuo dominio invece del sottodominio predefinito *.jamdesk.app.

Panoramica della configurazione

Opzioni di hosting

Quando aggiungi un dominio, scegli la modalità di hosting:

Dominio standard

La documentazione viene servita direttamente da Jamdesk sul tuo dominio personalizzato:

docs.example.com → acme.jamdesk.app

Il DNS punta a Jamdesk e i certificati SSL vengono gestiti automaticamente.

Hosting su /docs (proxy, sottopercorso personalizzabile)

La documentazione viene servita su un sottopercorso del tuo sito esistente:

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

/docs è il valore predefinito; puoi scegliere invece qualsiasi sottopercorso a un solo segmento (/help, /guide e così via) dallo stesso selettore. Configura un proxy (Cloudflare, Vercel, nginx e così via) per inoltrare a Jamdesk le richieste relative al sottopercorso scelto. Consulta Hosting su sottopercorso per le guide alla configurazione e le regole per scegliere un sottopercorso.

Configurazione DNS

I record necessari dipendono dal fatto che utilizzi un sottodominio o un dominio apex (radice).

Sottodomini (ad esempio docs.example.com)

Il campo "Name" contiene solo la parte relativa al sottodominio. Per docs.example.com, inserisci docs.

Domini apex (ad esempio example.com)

I domini apex utilizzano un record A invece di CNAME perché gli standard DNS (RFC 1034) vietano i record CNAME all'apice della zona.

Verifica

Dopo aver aggiunto i record DNS, Jamdesk esegue automaticamente queste operazioni:

1. Rileva i record DNS (record CNAME o A, più TXT)
2. Verifica la proprietà del dominio tramite il record TXT
3. Configura un certificato SSL tramite Let's Encrypt
4. Instrada il traffico verso la documentazione

Controlla lo stato della verifica in Settings → Domain. Lo stato può essere:

• Pending - In attesa della propagazione DNS
• Active - Dominio verificato e traffico attivo
• Needs Attention - Configurazione non corrispondente o conflitto (controlla la notifica email)
• Error - Problema di configurazione (consulta i dettagli nel dashboard)

Fai clic su Refresh nel dashboard per controllare manualmente lo stato della verifica.

Certificati SSL

I certificati SSL vengono configurati automaticamente e rinnovati prima della scadenza. HTTPS è obbligatorio, quindi le richieste HTTP vengono reindirizzate a HTTPS.

Non è necessario configurare manualmente i certificati.

Domini radice

I domini radice (apex), come example.com, sono pienamente supportati. Il dashboard mostra automaticamente i record corretti: un record A che punta a 76.76.21.21 invece di un CNAME, poiché gli standard DNS vietano i record CNAME all'apice della zona.

Se preferisci un sottodominio come docs.example.com, puoi utilizzare anche quello.

Più domini

Ogni progetto supporta un dominio personalizzato. Per più domini che puntano alla stessa documentazione:

1. Configura il dominio principale in Jamdesk
2. Configura i domini aggiuntivi in modo che reindirizzino al dominio principale a livello DNS/CDN

Rimozione di un dominio

Per scollegare un dominio personalizzato:

1. Vai a Settings → Domain
2. Fai clic su Remove Domain
3. La documentazione rimane accessibile al sottodominio *.jamdesk.app

Utenti Cloudflare

Se utilizzi Cloudflare come provider DNS:

1. Imposta lo stato del proxy su DNS only (icona della nuvola grigia) durante la verifica del dominio
2. Lascia che Vercel gestisca SSL: disabilita "Always Use HTTPS" di Cloudflare per il sottodominio della documentazione
3. Al termine della verifica, puoi riattivare il proxy (nuvola arancione)

Risoluzione dei problemi

Verifica il 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

Per una diagnostica dettagliata, consulta Risoluzione dei problemi DNS.

Il sottodominio jamdesk.app compete con il mio dominio nei risultati di ricerca?

No. Quando il tuo dominio personalizzato è attivo, le pagine servite direttamente dal sottodominio [slug].jamdesk.app includono un link canonico che punta al tuo dominio, quindi i motori di ricerca considerano il tuo dominio come unica fonte autorevole e consolidano lì tutti i segnali di ranking.

Quali sono i prossimi passaggi?