Configura la entrega de correo
El correo es la forma en que KolleK llega a las personas fuera de una sesión de navegador: las invitaciones, los enlaces mágicos, los restablecimientos de contraseña, la verificación de correo y las alertas de seguridad llegan todos por correo. Hasta que configures la entrega, ninguno llega a ningún sitio.
Por defecto no se envía nada
Una instancia recién instalada viene con MAIL_MAILER=log. Cada correo se escribe en el archivo de log de la aplicación en lugar de enviarse. Esto es intencionado: significa que una instancia configurada a medias nunca envía correo en silencio desde una dirección equivocada, y puedes leer exactamente qué se habría enviado mientras haces pruebas.
Si alguien dice "nunca me llegó la invitación" en una instancia nueva, casi siempre es por este valor por defecto. El correo existe, en el archivo de log. Consulta Solución de problemas: entrega de correos.
Tienes dos formas compatibles de enviar correo real: cualquier servidor SMTP, o el servicio Resend.
Opción 1: SMTP
En .env, define:
MAIL_MAILER=smtp
MAIL_HOST=smtp.yourprovider.com
MAIL_PORT=587
MAIL_USERNAME=your-username
MAIL_PASSWORD=your-password
Funciona con cualquier proveedor de correo transaccional o servidor de correo propio que tenga credenciales SMTP.
Define la dirección y el nombre que verán tus usuarios:
MAIL_FROM_ADDRESS=kollek@yourdomain.com
MAIL_FROM_NAME="KolleK"
Usa un dominio que controles y que tengas configurado para el envío (SPF y DKIM en tu proveedor), o tu correo acabará en la carpeta de spam.
Recrea los contenedores y a continuación provoca un correo real, por ejemplo solicitando un enlace mágico desde la página de inicio de sesión:
docker compose up -d
Opción 2: Resend
Si usas Resend, define:
USE_RESEND=true
RESEND_API_KEY=re_your_api_key
Los correos se envían entonces a través de la API de Resend en lugar de SMTP, y cada envío registra junto a él el identificador del mensaje en Resend.
Comprobar que la entrega funciona
KolleK registra cada correo que envía, por usuario, con su asunto, cuerpo y estado de entrega. Después de tu prueba, revisa dos lugares:
- Tu bandeja de entrada, por el motivo obvio.
- La página de correos enviados del destinatario en su perfil, que lista lo que la instancia le envió. Consulta Tu registro de actividad personal y tus correos enviados.
Señales habituales de fallo:
- No llega nada y no hay ningún error. El mailer sigue siendo
log. Comprueba que.envse aplicó recreando los contenedores. - Los correos se envían pero acaban en spam. El dominio del remitente no está autenticado. Configura SPF y DKIM en tu proveedor.
- Errores de envío en el log. Las credenciales o los datos del servidor son incorrectos. Los logs del worker de la cola contienen el mensaje de error del proveedor.
Los correos los envía la cola en segundo plano, así que el contenedor queue debe estar en funcionamiento para que algo salga de la instancia.
Por dónde seguir
- Reconoce los correos que envía tu instancia en Correos que envía KolleK.
- Diagnostica problemas de entrega en Solución de problemas: entrega de correos.