Saltar al contenido

Autoalojamiento

Cambiar tu dominio

Traslada una instancia de Notifuse a una nueva dirección y abre la consola en los dominios personalizados de los espacios de trabajo.

Notifuse toma su dirección pública de API_ENDPOINT, definida como variable de entorno o guardada por el asistente de configuración; si existen las dos, gana la variable de entorno. La consola envía ahí todas sus solicitudes, y la dirección se escribe en los correos, las invitaciones, los webhooks registrados en tus proveedores de correo y la URI de redirección del SSO. Para trasladar una instancia, cambia API_ENDPOINT y luego actualiza los lugares que copiaron la dirección.

Advertencia

Mantén el dominio antiguo apuntando a Notifuse, o redirigiendo al nuevo con la ruta y la query string intactas, mientras alguien pueda abrir correos que ya enviaste. Sus enlaces de seguimiento, baja, centro de notificaciones y versión web llevan la dirección antigua, y un correo entregado no se puede actualizar.

Pasar al nuevo dominio

  1. Enruta el nuevo dominio a Notifuse en tu proxy inverso, con un certificado TLS, y mantén también enrutado el dominio antiguo.
  2. Cambia API_ENDPOINT:
    • Si es una variable de entorno: cámbiala y reinicia Notifuse.
    • Si la guardó el asistente de configuración: inicia sesión como root en el dominio antiguo, abre Configuración del sistema (el botón encima de la lista de espacios de trabajo), cambia Punto final API y guarda. Al guardar, Notifuse se reinicia: el proceso termina y tu contenedor o gestor de servicios lo vuelve a arrancar (el archivo Docker Compose proporcionado lo hace con restart: unless-stopped). El campo está desactivado cuando la variable de entorno está definida, porque esa variable lo anularía.
  3. Vuelve a iniciar sesión en el nuevo dominio. Las sesiones se guardan por dirección, así que una sesión abierta en el dominio antiguo no se conserva.
  4. Revisa la lista de abajo.

Nota

¿Sin acceso después del traslado? Si el dominio antiguo ya no llega a Notifuse, la consola en el nuevo dominio tampoco llega a su API; la página de inicio de sesión muestra la dirección que intentó. Define API_ENDPOINT con la nueva dirección como variable de entorno y reinicia: anula el valor guardado por el asistente de configuración.

Qué más usa la dirección

Usa la direcciónDespués del cambioQué hacer
Enlaces de los correos ya enviados: seguimiento de clics, seguimiento de aperturas, baja, List-Unsubscribe, centro de notificaciones, versión webSiguen apuntando al dominio antiguoMantén el dominio antiguo enrutado a Notifuse. Los espacios de trabajo con una URL de punto final personalizado usan ese dominio y no se ven afectados. Si rediriges el dominio antiguo al nuevo, los enlaces de baja y de centro de notificaciones envueltos por el seguimiento de clics en correos enviados antes de 42.2 muestran primero una página de confirmación, lo que cuesta un clic más. Cuando un espacio de trabajo cambia su propio dominio personalizado, redirige el antiguo a API_ENDPOINT, no al nuevo dominio personalizado: una versión web solo se abre en el dominio con el que se envió y en API_ENDPOINT.
Invitaciones pendientes a espacios de trabajoEnlazan al dominio antiguoMantén el dominio antiguo enrutado o reenvía las invitaciones: una invitación reenviada usa la nueva dirección.
Webhooks de los proveedores de correoSe registraron una sola vez, con la dirección de ese momentoPara cada integración, abre Configuración → Integraciones y elige Volver a registrar webhooks en su menú ⋯. Consulta Webhooks de los proveedores de correo.
WEBHOOK_ENDPOINTSi está definida, sustituye a API_ENDPOINT para los webhooksCámbiala también y vuelve a registrar.
Inicio de sesión únicoLa URI de redirección se deriva de API_ENDPOINT, salvo que OIDC_REDIRECT_URI esté definidaAñade https://<new-domain>/api/user.oidc.callback en tu proveedor de identidad y actualiza OIDC_REDIRECT_URI si la definiste. Consulta Inicio de sesión único.
URL copiadas en otras herramientas: hooks de autenticación de Supabase, la conexión de Zapier, aplicaciones que llaman a la APISiguen llamando al dominio antiguoActualízalas con la nueva dirección.
El fragmento de analítica web instalado en tus sitiosSu endpoint y la URL de su script nombran el dominio antiguo, salvo que el espacio de trabajo tenga una URL de punto final personalizadoInstala el fragmento actualizado o mantén el dominio antiguo enrutado.
URL de punto final personalizado de los espacios de trabajoSu comprobación DNS espera un CNAME hacia el host de API_ENDPOINT, y solo se ejecuta cuando se define o se cambia un dominio personalizadoLos dominios personalizados existentes siguen funcionando mientras el destino de su CNAME siga llegando a Notifuse. Apúntalos al nuevo host cuando te venga bien.
CORS_ALLOW_ORIGINSi está definida, lista los orígenes autorizados a llamar a la APIAñade el nuevo origen. Consulta Dominios personalizados de los espacios de trabajo.

Webhooks de los proveedores de correo

Notifuse registra su webhook en tu proveedor de correo al crear la integración, con la dirección de ese momento, y nunca lo actualiza por su cuenta. Volver a registrar webhooks envía la nueva dirección:

  • Mailgun y SendGrid sustituyen la dirección antigua.
  • Postmark, SparkPost, Mailjet y Amazon SES añaden la nueva dirección junto a la antigua. Elimina el webhook antiguo en el panel del proveedor, o en Amazon SES la suscripción SNS antigua, para que los eventos no lleguen dos veces.

Una integración puede aparecer como registrada aunque su webhook siga apuntando al dominio antiguo. Pasa el cursor sobre el estado de los webhooks de una integración en Configuración → Integraciones para ver la dirección que usa cada endpoint.

Amazon SES confirma automáticamente la nueva suscripción SNS en cuanto AWS puede llegar a Notifuse en el nuevo dominio.

Abrir la consola en el dominio personalizado de un espacio de trabajo

La URL de punto final personalizado de un espacio de trabajo también sirve la consola: si un espacio de trabajo usa https://news.example.com, sus miembros pueden iniciar sesión en https://news.example.com/console. La consola y el centro de notificaciones abiertos ahí envían sus solicitudes a API_ENDPOINT, desde el origen del dominio personalizado.

  • Con el valor por defecto de CORS_ALLOW_ORIGIN (*) no hay nada que configurar.
  • Si restringes CORS_ALLOW_ORIGIN, incluye todos los dominios personalizados de los espacios de trabajo, separados por comas: CORS_ALLOW_ORIGIN=https://news.example.com,https://mail.other-brand.com. Desde un dominio que no esté en la lista no se puede iniciar sesión en la consola, y su centro de notificaciones no puede cargar las preferencias.
  • Las sesiones se guardan por dirección: iniciar sesión en un dominio personalizado no te conecta en el dominio principal, ni a la inversa.
  • El inicio de sesión único y los enlaces de invitación terminan en la dirección de API_ENDPOINT, no en el dominio personalizado.