Prueba los emails de Laravel en local en tu Mac

Captura cada email que envía tu app Laravel en desarrollo con un servidor SMTP local en tu Mac. Configura .env en un minuto, sin Docker ni cuenta de Mailtrap.

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_PORT no 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 configurar QUEUE_CONNECTION=sync en local.
  • Se siguen usando los valores antiguos — vuelve a ejecutar php artisan config:clear despué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.

Más guías