Search by

ebbbang / laravel-mailroom

ebbbang

A Laravel mail driver that stores outgoing mail in your database, plus a mailbox to read it.

v0.11.0 2026-10-30 08:19 UTC

This package is auto-updated.

Last update: 2026-11-14 04:33:11 UTC


README

Latest version Tests Downloads License

Keep every email your app sends. Read it in a real mailbox.

A Laravel mail driver that stores outgoing mail in your database, plus a mailbox to read it.

MAIL_MAILER=log flattens a message into a log line and throws away the attachments. MAIL_MAILER=array forgets everything at the end of the request. Mailroom keeps the whole thing: full MIME, attachments, embedded images, tags, metadata, custom headers. And it gives you somewhere to look at it.

There is nothing else to run: no Docker container, no SMTP port to point the app at, no account with a hosted inbox. The mailbox is a route in your application, so it works the same on a laptop, in CI and on a staging server your testers share.

The mail stays in your own database and storage, so no third party holds copies of your users' emails, and pruning deletes them on a schedule you set. It leaves only when someone forwards a message or runs a spam check, and both are off until you configure them.

Documentation: ebbbang.github.io/laravel-mailroom

The Mailroom mailbox: a sidebar of mailboxes, people and mailers, the message list, and an open message showing its rendered HTML

Installation

composer require --dev ebbbang/laravel-mailroom
php artisan mailroom:install

Open /mailroom and your next email will be there. Requires PHP 8.2+ and Laravel 12 or 13 (11 on v0.10).

Documentation

The same pages are in docs/, readable here on GitHub.

Changelog

See CHANGELOG.md.

Contributing

See CONTRIBUTING.md. It covers the workbench demo mailbox, which seeds one message per branch of the UI so you can see every state without composing mail by hand, and running the docs site locally.

Please note the Code of Conduct.

Security

Please do not open a public issue for a vulnerability. SECURITY.md explains how to report privately, and documents the threat model. The mailbox renders attacker-controlled content by design, and how that is contained is worth reading before reporting.

Credits

License

MIT. See LICENSE.