https://github.com/roots/ansible-role-mailpit
Ansible Role - Mailpit email testing for developers
https://github.com/roots/ansible-role-mailpit
Last synced: 6 months ago
JSON representation
Ansible Role - Mailpit email testing for developers
- Host: GitHub
- URL: https://github.com/roots/ansible-role-mailpit
- Owner: roots
- License: mit
- Created: 2023-02-18T18:02:25.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-13T10:28:39.000Z (about 1 year ago)
- Last Synced: 2025-06-29T20:41:50.838Z (6 months ago)
- Language: Jinja
- Size: 12.7 KB
- Stars: 3
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Ansible Role: Mailpit
Installs [Mailpit](https://github.com/axllent/mailpit), an email testing tool for developers, on RedHat or Debian-based linux systems.
Mailpit acts as both an SMTP server, and provides a web interface to view all captured emails. Mailpit is inspired by MailHog, but much, much faster.
This role is based on https://github.com/geerlingguy/ansible-role-mailhog
If you're using PHP and would like to route all PHP email into Mailpit, you will need to update the `sendmail_path` configuration option in php.ini, like so:
```yaml
sendmail_path = "{{ mailpit_install_dir }}/mailpit sendmail"
```
## Requirements
A Debian-based (eg: Ubuntu) or RedHat system running systemd.
## Role Variables
Available variables are listed below, along with default values (see `defaults/main.yml`):
```yaml
mailpit_install_dir: /opt/mailpit
```
The directory into which the MailHog binary will be installed.
```yaml
mailpit_version: 1.3.8
```
The version of Mailpit that will be installed. You can find the latest version by visiting the [Mailpit project releases page](https://github.com/axllent/mailpit/releases).
```yaml
mailpit_release_url: "https://github.com/axllent/mailpit/releases/download/v{{ mailpit_version }}/mailhog-linux-amd64"
```
## Example Playbook
```yaml
- hosts: servers
roles:
- { role: roots.mailpit }
```
## Community
Keep track of development and community news.
- Join us on Discord by [sponsoring us on GitHub](https://github.com/sponsors/roots)
- Participate on the [Roots Discourse](https://discourse.roots.io/)
- Follow [@rootswp on Twitter](https://twitter.com/rootswp)
- Read and subscribe to the [Roots Blog](https://roots.io/blog/)
- Subscribe to the [Roots Newsletter](https://roots.io/subscribe/)