Prueba los emails de Rails en local en tu Mac

Envía cada email de Action Mailer de tu app Rails a un servidor SMTP local en tu Mac. Configura development.rb en un minuto y revisa cada email al instante.

Por defecto, Rails en desarrollo intenta entregar por SMTP e ignora en silencio los errores de entrega, así que solo ves los emails en el log: suficiente para una comprobación rápida, un suplicio cuando necesitas ver el HTML real. Con Mailbox, Action Mailer entrega a un servidor SMTP local en tu Mac y cada email aparece renderizado, con cabeceras, parte de texto plano y adjuntos. Nada llega a una bandeja de entrada real.

1. Inicia un servidor en Mailbox

Abre Mailbox. La primera vez que lo abres crea un servidor en el puerto 2525 — asegúrate de que esté iniciado. Si en su lugar añades otro servidor, Mailbox le asigna un puerto libre; usa ese puerto en los pasos siguientes.

2. Configura Action Mailer

En config/environments/development.rb:

config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
  address: "127.0.0.1",
  port: 2525
}
config.action_mailer.raise_delivery_errors = true
config.action_mailer.default_url_options = { host: "localhost", port: 3000 }

Mailbox no usa autenticación SMTP ni TLS, así que omite user_name, password y authentication. raise_delivery_errors hace que un puerto incorrecto falle de forma visible en lugar de en silencio, y default_url_options hace que los enlaces de tus emails apunten a tu app local.

Reinicia el servidor de Rails después de cambiar los archivos de entorno.

3. Envía un email de prueba

La forma más rápida de comprobarlo es enviar un email puntual desde el runner:

bin/rails runner 'ActionMailer::Base.mail(from: "app@example.com", to: "test@example.com", subject: "Hello from Rails", body: "It works!").deliver_now'

Después, dispara un mailer real — regístrate, restablece una contraseña — y llegará a la misma bandeja de entrada.

Ejecutar Rails en Docker

Dentro de un contenedor, 127.0.0.1 es el propio contenedor. Apunta Action Mailer a tu Mac en su lugar:

config.action_mailer.smtp_settings = { address: "host.docker.internal", port: 2525 }

Si el contenedor sigue sin poder conectarse, activa Permitir acceso a la red en Mailbox (Configuración → General) y reinicia el servidor para que acepte conexiones desde fuera de la interfaz de loopback.

Solución de problemas

  • Errno::ECONNREFUSED — el servidor de Mailbox no está en ejecución o el puerto no coincide.
  • No llega nada y no hay ningún error — los jobs de deliver_later necesitan un adaptador de colas en ejecución (Solid Queue, Sidekiq…). Usa deliver_now mientras pruebas o arranca tu worker de jobs.
  • Sigue registrando en la consola — otro archivo de entorno o un initializer sobrescribe delivery_method; busca delivery_method en el proyecto.

Qué revisar a continuación

Mailbox te muestra cómo se comportan tus plantillas más allá del navegador: la verificación de compatibilidad HTML señala el CSS que Outlook o Gmail ignoran, y la vista previa móvil muestra el email en un viewport del tamaño de un teléfono. Las previsualizaciones de mailers (/rails/mailers) siguen siendo geniales para iterar sobre una sola plantilla; Mailbox captura lo que tu app envía de verdad, de principio a fin.

Más guías