Mailpit for Local Email Testing

Mailpit captures development email in a private local inbox. It lets you review message content and links without delivering to real guests.

Typical local settings

MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=1025
MAIL_USERNAME=
MAIL_PASSWORD=
MAIL_ENCRYPTION=

Open the local Mailpit web interface at the address configured for the installation (commonly port 8025). These values are for development only.

What to test

1. Start Mailpit before sending.
2. Send a password reset and confirm the recipient, subject, expiry language, and link host.
3. Create a sample booking and inspect dates, room names, totals, and policy text.
4. Issue a sample receipt/invoice and compare it with the folio.
5. Send a room-condition signature request and confirm the guest token opens the intended report only.

Mail-enabled workflows

• Account recovery and verification.
• Booking confirmation, modification, cancellation, and reminders.
• Invoices, receipts, payment links, and refund notices.
• Room-condition inspection, signature, and dispute notifications.
• Housekeeping, maintenance, and operational alerts.

Troubleshooting

If no message appears, confirm Mailpit is running, the SMTP port is correct, and the queue worker processed the job. Inspect failed jobs and application logs. After changing mail values, clear configuration cache and restart workers.