> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cambiare il dominio

> Sposta un'istanza Notifuse su un nuovo indirizzo e apri la console sui domini personalizzati dei workspace.

Notifuse prende il suo indirizzo pubblico da `API_ENDPOINT`, impostato come variabile d'ambiente o salvato dalla procedura guidata di configurazione; se esistono entrambi, vince la variabile d'ambiente. La console invia lì ogni richiesta, e l'indirizzo viene scritto nelle email, negli inviti, nei webhook registrati presso i tuoi provider email e nell'URI di reindirizzamento SSO. Per spostare un'istanza, cambia `API_ENDPOINT` e poi aggiorna i punti che lo hanno copiato.

> [!WARNING]
>
> Lascia il vecchio dominio puntato su Notifuse, oppure reindirizzalo al nuovo mantenendo intatti percorso e query string, finché qualcuno potrebbe aprire le email che hai già inviato. I loro link di tracciamento, disiscrizione, centro notifiche e versione web contengono il vecchio indirizzo, e un'email consegnata non si può aggiornare.

## Passare al nuovo dominio

1. Instrada il nuovo dominio verso Notifuse nel tuo reverse proxy, con un certificato TLS, e lascia instradato anche il vecchio dominio.
2. Cambia `API_ENDPOINT`:
   - **Se è impostato come variabile d'ambiente**: cambiala e riavvia Notifuse.
   - **Se è salvato dalla procedura guidata di configurazione**: accedi come root sul vecchio dominio, apri **Impostazioni di sistema** (il pulsante sopra l'elenco dei workspace), cambia **API Endpoint** e salva. Il salvataggio riavvia Notifuse: il processo termina e il tuo container o gestore di servizi lo riavvia (il file Docker Compose fornito lo fa con `restart: unless-stopped`). Il campo è disattivato quando la variabile d'ambiente è impostata, perché quella variabile lo sovrascriverebbe.
3. Accedi di nuovo sul nuovo dominio. Le sessioni sono legate all'indirizzo, quindi una sessione aperta sul vecchio dominio non viene ripresa.
4. Segui l'elenco qui sotto.

> [!NOTE]
>
> **Non riesci più ad accedere dopo il trasferimento?** Se il vecchio dominio non raggiunge più Notifuse, nemmeno la console sul nuovo dominio riesce a raggiungere la sua API; la pagina di accesso mostra l'indirizzo che ha provato. Imposta `API_ENDPOINT` sul nuovo indirizzo come variabile d'ambiente e riavvia: prevale sul valore salvato dalla procedura guidata di configurazione.

## Cos'altro usa l'indirizzo

| Usa l'indirizzo                                                                                                                                     | Dopo il cambiamento                                                                                                                                         | Cosa fare                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Link nelle email già inviate: tracciamento dei clic, tracciamento delle aperture, disiscrizione, `List-Unsubscribe`, centro notifiche, versione web | Continuano a puntare al vecchio dominio                                                                                                                     | Lascia il vecchio dominio instradato verso Notifuse. I workspace con un [URL endpoint personalizzato](https://www.notifuse.com/it/docs/features/workspaces.md#custom-endpoint-url) usano invece quel dominio e non sono interessati. Se reindirizzi il vecchio dominio al nuovo, i link di disiscrizione e del centro notifiche avvolti dal tracciamento dei clic nelle email inviate prima della 42.2 mostrano prima una [pagina di conferma](https://www.notifuse.com/it/docs/features/workspaces.md#tracked-links), che costa un clic in più. Quando un workspace cambia il proprio dominio personalizzato, reindirizza quello vecchio verso `API_ENDPOINT`, non verso il nuovo dominio personalizzato: una versione web si apre solo sul dominio con cui è stata inviata e su `API_ENDPOINT`. |
| Inviti ai workspace in attesa                                                                                                                       | Puntano al vecchio dominio                                                                                                                                  | Lascia instradato il vecchio dominio, oppure invia di nuovo gli inviti: un invito reinviato usa il nuovo indirizzo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Webhook dei provider email                                                                                                                          | Registrati una sola volta, con l'indirizzo di quel momento                                                                                                  | Per ogni integrazione, apri **Impostazioni → Integrazioni** e scegli **Registra di nuovo i webhook** nel suo menu **⋯**. Vedi [Webhook dei provider email](#email-provider-webhooks).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `WEBHOOK_ENDPOINT`                                                                                                                                  | Se impostato, sostituisce `API_ENDPOINT` per i webhook                                                                                                      | Cambia anche questo, poi registra di nuovo i webhook.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Single sign-on                                                                                                                                      | L'URI di reindirizzamento deriva da `API_ENDPOINT`, a meno che non sia impostato `OIDC_REDIRECT_URI`                                                        | Aggiungi `https://<new-domain>/api/user.oidc.callback` presso il tuo identity provider, e aggiorna `OIDC_REDIRECT_URI` se l'hai impostato. Vedi [Single Sign-On](https://www.notifuse.com/it/docs/self-hosting/sso.md).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| URL copiati in altri strumenti: hook di autenticazione Supabase, la connessione Zapier, applicazioni che chiamano l'API                             | Chiamano ancora il vecchio dominio                                                                                                                          | Aggiornali con il nuovo indirizzo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Lo snippet di web analytics installato sui tuoi siti                                                                                                | Il suo `endpoint` e l'URL del suo script indicano il vecchio dominio, a meno che il workspace non abbia un URL endpoint personalizzato                      | Installa lo snippet aggiornato, oppure lascia instradato il vecchio dominio.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| URL endpoint personalizzati dei workspace                                                                                                           | Il loro controllo DNS si aspetta un CNAME verso l'host di `API_ENDPOINT`, e viene eseguito solo quando un dominio personalizzato viene impostato o cambiato | I domini personalizzati esistenti continuano a funzionare finché la destinazione del loro CNAME raggiunge ancora Notifuse. Puntali al nuovo host quando ti è comodo.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `CORS_ALLOW_ORIGIN`                                                                                                                                 | Se impostato, elenca le origini autorizzate a chiamare l'API                                                                                                | Aggiungi la nuova origine. Vedi [Domini personalizzati dei workspace](#opening-the-console-on-a-workspace-custom-domain).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

### Webhook dei provider email

Notifuse registra il suo webhook presso il tuo provider email quando crei l'integrazione, con l'indirizzo di quel momento, e non lo aggiorna mai da solo. **Registra di nuovo i webhook** invia il nuovo indirizzo:

- **Mailgun** e **SendGrid** sostituiscono il vecchio indirizzo.
- **Postmark**, **SparkPost**, **Mailjet** e **Amazon SES** aggiungono il nuovo indirizzo accanto al vecchio. Elimina il vecchio webhook nella dashboard del provider, oppure, per Amazon SES, la vecchia sottoscrizione SNS, così gli eventi non vengono consegnati due volte.

Un'integrazione può risultare registrata anche se il suo webhook punta ancora al vecchio dominio. Passa il mouse sullo stato dei webhook di un'integrazione in **Impostazioni → Integrazioni** per vedere l'indirizzo usato da ogni endpoint.

Amazon SES conferma automaticamente la nuova sottoscrizione SNS, appena AWS riesce a raggiungere Notifuse sul nuovo dominio.

## Aprire la console sul dominio personalizzato di un workspace

L'URL endpoint personalizzato di un workspace serve anche la console: se un workspace usa `https://news.example.com`, i suoi membri possono accedere da `https://news.example.com/console`. La console e il centro notifiche aperti lì inviano le loro richieste a `API_ENDPOINT`, dall'origine del dominio personalizzato.

- Con il valore predefinito di `CORS_ALLOW_ORIGIN` (`*`) non c'è nulla da configurare.
- Se restringi `CORS_ALLOW_ORIGIN`, elenca tutti i domini personalizzati dei workspace, separati da virgole: `CORS_ALLOW_ORIGIN=https://news.example.com,https://mail.other-brand.com`. Da un dominio escluso non si può accedere alla console, e il suo centro notifiche non riesce a caricare le preferenze.
- Le sessioni sono legate all'indirizzo: accedere su un dominio personalizzato non ti fa accedere sul dominio principale, e viceversa.
- I link di single sign-on e di invito terminano sull'indirizzo di `API_ENDPOINT`, non sul dominio personalizzato.
