Vai al contenuto

Self-hosting

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.

Attenzione

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.

Nota

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’indirizzoDopo il cambiamentoCosa fare
Link nelle email già inviate: tracciamento dei clic, tracciamento delle aperture, disiscrizione, List-Unsubscribe, centro notifiche, versione webContinuano a puntare al vecchio dominioLascia il vecchio dominio instradato verso Notifuse. I workspace con un URL endpoint personalizzato 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, 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 attesaPuntano al vecchio dominioLascia instradato il vecchio dominio, oppure invia di nuovo gli inviti: un invito reinviato usa il nuovo indirizzo.
Webhook dei provider emailRegistrati una sola volta, con l’indirizzo di quel momentoPer ogni integrazione, apri Impostazioni → Integrazioni e scegli Registra di nuovo i webhook nel suo menu ⋯. Vedi Webhook dei provider email.
WEBHOOK_ENDPOINTSe impostato, sostituisce API_ENDPOINT per i webhookCambia anche questo, poi registra di nuovo i webhook.
Single sign-onL’URI di reindirizzamento deriva da API_ENDPOINT, a meno che non sia impostato OIDC_REDIRECT_URIAggiungi 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.
URL copiati in altri strumenti: hook di autenticazione Supabase, la connessione Zapier, applicazioni che chiamano l’APIChiamano ancora il vecchio dominioAggiornali con il nuovo indirizzo.
Lo snippet di web analytics installato sui tuoi sitiIl suo endpoint e l’URL del suo script indicano il vecchio dominio, a meno che il workspace non abbia un URL endpoint personalizzatoInstalla lo snippet aggiornato, oppure lascia instradato il vecchio dominio.
URL endpoint personalizzati dei workspaceIl loro controllo DNS si aspetta un CNAME verso l’host di API_ENDPOINT, e viene eseguito solo quando un dominio personalizzato viene impostato o cambiatoI domini personalizzati esistenti continuano a funzionare finché la destinazione del loro CNAME raggiunge ancora Notifuse. Puntali al nuovo host quando ti è comodo.
CORS_ALLOW_ORIGINSe impostato, elenca le origini autorizzate a chiamare l’APIAggiungi la nuova origine. Vedi Domini personalizzati dei workspace.

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.