Mailpit Integration Plugin for Lando

The official Mailpit integration plugin for Lando. Mailpit is a modern email testing tool for developers that makes it easy to test email sending in your local development environment.

Features

• ✅ A Mailpit service for receiving emails
• ✅ Mailpit UI accessible at http and https routes
• ✅ Automatic configuration of services to send mail to Mailpit
• ✅ Automatic installation of Mailpit sendmail client and configuration into services that need it
• ✅ A lando mailpit command that shows connection information

Installation

lando plugin-add @lando/mailpit

Usage

1. Configure your Landofile

Add a mailpit service to your landofile:

services:
  mailpit:
    type: mailpit:1.22
    mailFrom: # Defaults to appserver.
      - appserver

# Optionally proxy the Mailpit UI to a custom URL.
proxy:
  mailpit:
    - myapp.lndo.site/mailpit

The mailFrom option is an array of services that will be configured to send mail to Mailpit. By default, this will be the appserver service.

For detailed configuration options, see our configuration documentation.

2. Send and View Emails

Send mail from your PHP app:

<?php
$to = 'recipient@example.com';
$subject = 'Test email from My App';
$message = 'This is a test email sent via PHP.';
$headers = [
    'From: sender@example.com',
    'Content-Type: text/plain; charset=utf-8'
];

mail($to, $subject, $message, implode("\r\n", $headers));

View captured emails in the Mailpit UI at the proxy URL configured above:

• http://myapp.lndo.site/mailpit

Commands

lando mailpit

Shows connection information for the Mailpit service, including:

• SMTP server host and port
• Pre-configured services that use sendmail
• Environment variables available for custom configurations

Development

For information about developing and contributing to this plugin, please see our development documentation.