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_laternecesitan un adaptador de colas en ejecución (Solid Queue, Sidekiq…). Usadeliver_nowmientras pruebas o arranca tu worker de jobs. - Sigue registrando en la consola — otro archivo de entorno o un initializer sobrescribe
delivery_method; buscadelivery_methoden 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.