Laravel hace que enviar emails sea muy fácil — y por eso también es muy fácil mandarle un restablecimiento de contraseña a un cliente real desde tu portátil. Apuntar tu app local a Mailbox lo soluciona: cada mailable, notificación y llamada a Mail::raw() llega a Mailbox en tu Mac, donde puedes inspeccionar el HTML, las cabeceras y los adjuntos. No se entrega nada.
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. Apunta Laravel a Mailbox
Las versiones recientes de Laravel ya incluyen un .env con MAIL_HOST=127.0.0.1 y MAIL_PORT=2525, justo donde escucha Mailbox. Normalmente la única línea que hay que cambiar es MAIL_MAILER, de log a smtp. El bloque completo queda así:
MAIL_MAILER=smtp
MAIL_SCHEME=null
MAIL_HOST=127.0.0.1
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"
Mailbox no usa autenticación SMTP ni TLS, así que deja el usuario, la contraseña y el esquema en null; así Laravel usa SMTP sin cifrar en cualquier puerto que no sea el 465. En Laravel 10 y anteriores la clave se llama MAIL_ENCRYPTION en lugar de MAIL_SCHEME; ponla también en null.
Si tienes la configuración en caché, límpiala para que Laravel cargue los nuevos valores:
php artisan config:clear
3. Envía un email de prueba
Laravel no trae un comando de prueba integrado, pero basta con una línea de Tinker:
php artisan tinker --execute='Mail::raw("It works!", fn ($m) => $m->to("test@example.com")->subject("Hello from Laravel"));'
El email aparece en Mailbox al instante. Tus mailables y notificaciones reales siguen el mismo camino: provoca un restablecimiento de contraseña o un registro y aparecerán en la misma bandeja de entrada.
Con Laravel Sail, DDEV o Docker
Dentro de un contenedor, 127.0.0.1 es el propio contenedor, no tu Mac. Usa host.docker.internal en su lugar:
MAIL_HOST=host.docker.internal
MAIL_PORT=2525
Sail instala por defecto un contenedor de Mailpit y apunta MAIL_HOST hacia él. Cuando te pases a Mailbox, elimina el servicio mailpit de compose.yaml y de la lista depends_on de laravel.test, o instala Sail sin él: php artisan sail:install --with=mysql,redis.
DDEV reescribe los valores MAIL_* del .env en cada ddev start. Ejecuta primero ddev config --disable-settings-management (esto también hace que DDEV deje de gestionar los valores DB_*) y después configura el host y el puerto de arriba. DDEV espera que los servicios del host escuchen en todas las interfaces, así que activa Permitir acceso a la red en Mailbox (Configuración → General) y reinicia el servidor.
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
- “Connection could not be established” — el servidor no está en ejecución o
MAIL_PORTno coincide con el puerto de Mailbox. - No llega nada y no hay ningún error — los mailables en cola (
ShouldQueue) solo se envían cuando hay un worker en ejecución:php artisan queue:work. También puedes configurarQUEUE_CONNECTION=syncen local. - Se siguen usando los valores antiguos — vuelve a ejecutar
php artisan config:cleardespués de editar.env.
Qué revisar a continuación
Cuando empiecen a llegar los emails, usa la verificación de compatibilidad HTML de Mailbox para ver de qué CSS dependen tus plantillas que Outlook o Gmail no renderizan, y la vista previa móvil para revisar el diseño en un viewport del tamaño de un teléfono. ¿Tienes varias apps? Con Mailbox Pro, dale a cada una su propio servidor y puerto para que sus emails nunca se mezclen.