---
title: Domini personalizzati
description: Servi la documentazione dal tuo dominio invece del sottodominio predefinito *.jamdesk.app. Configura DNS, SSL e verifica per sottodomini e domini apex.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

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

## Panoramica della configurazione

<Steps>
  <Step title="Aggiungi il dominio nel dashboard">
    Vai a **Settings** → **Domain** del progetto e inserisci il tuo dominio (ad esempio `docs.example.com` o `example.com`).
  </Step>
  <Step title="Configura il DNS">
    Aggiungi al tuo provider DNS i record DNS mostrati nel dashboard. I record dipendono dal tipo di dominio (vedi sotto).
  </Step>
  <Step title="Verifica e attendi">
    Jamdesk verifica la proprietà e configura automaticamente un certificato SSL.
  </Step>
</Steps>

## 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:

```text
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:

```text
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](/it/deploy/subpath-hosting) per le guide alla configurazione e le regole per scegliere un sottopercorso.

<Note>
Attivare o disattivare "Host at a subpath", oppure modificare il sottopercorso, attiva una build automatica perché la struttura degli URL cambia.
</Note>

## Configurazione DNS

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

### Sottodomini (ad esempio docs.example.com)

| Type | Name | Value |
|------|------|-------|
| CNAME | `docs` | `cname.jamdesk.com` |
| TXT | `_jamdesk.docs` | *(shown in dashboard)* |

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

### Domini apex (ad esempio example.com)

| Type | Name | Value |
|------|------|-------|
| A | `@` | `76.76.21.21` |
| TXT | `_jamdesk` | *(shown in dashboard)* |

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

<Note>
La propagazione delle modifiche DNS può richiedere fino a 48 ore, anche se nella maggior parte dei casi si completa in pochi minuti. Controlla lo stato su [whatsmydns.net](https://www.whatsmydns.net/).
</Note>

## 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`

<Warning>
La rimozione di un dominio per cui era attivo "Host at a subpath" attiva una build per aggiornare i percorsi degli URL. Qualsiasi sottopercorso personalizzato viene eliminato insieme al dominio; se in seguito ricolleghi un dominio, la documentazione riparte dal valore predefinito `/docs`.
</Warning>

## 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)

<Note>
**Utilizzi un Worker Cloudflare?** Il record DNS deve essere sottoposto a proxy (nuvola arancione) per consentire l'esecuzione del Worker. Usa la nuvola grigia solo durante la verifica, quindi ripristina la nuvola arancione. Consulta [Configurazione dei Cloudflare Workers](/it/deploy/cloudflare) per i dettagli.
</Note>

## Risoluzione dei problemi

| Problema | Soluzione |
|-------|----------|
| Dominio bloccato su "Pending" | Controlla i record DNS con `dig` (CNAME per i sottodomini, A per i domini apex) |
| Errori del certificato SSL | Assicurati che nessun record CAA blocchi Let's Encrypt |
| Cicli di reindirizzamento | Se utilizzi Cloudflare, imposta la nuvola grigia durante la verifica (vedi [Utenti Cloudflare](#utenti-cloudflare) sopra) |
| CNAME non risolto | Verifica il record presso il provider DNS e attendi la propagazione |
| Dominio già in uso | Il dominio è registrato in Vercel da una configurazione precedente; la verifica di solito viene completata automaticamente |

### Verifica il DNS con dig

```bash
# 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](/it/help/troubleshooting/dns-issues).

## 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?

<Columns cols={2}>
  <Card title="Sottodomini" icon="sitemap" href="/it/deploy/subdomains">
    Configura impostazioni specifiche per i sottodomini
  </Card>
  <Card title="Hosting su sottopercorso" icon="route" href="/it/deploy/subpath-hosting">
    Ospita la documentazione su example.com/docs
  </Card>
  <Card title="Risoluzione dei problemi DNS" icon="server" href="/it/help/troubleshooting/dns-issues">
    Diagnostica i problemi di configurazione DNS
  </Card>
</Columns>