Mailpit package proposition

Contribute Room Apps packaging
, , ,
1

Hi everyone,

I’d like to propose a new package for the YunoHost catalog today: Mailpit.

For those who might not know it, Mailpit is the modern, lightning-fast, and actively maintained successor to the popular tool MailHog. It’s an essential utility for developers and sysadmins managing test or staging environments on their servers.
Official website :
https://mailpit.axllent.org

:hammer_and_wrench: What is Mailpit and what is it used for?

Mailpit acts as an email sinkhole. Once installed, it provides a local SMTP server. Any application configured to use it will send its emails there, but Mailpit never actually delivers them to the internet. Instead, it intercepts them and displays them in a sleek, lightweight web interface.

It’s the perfect tool for:

  • Testing transactional flows (user registrations, newsletters, WooCommerce Subscriptions/Stripe orders) without the risk of spamming real customers in your database with test data.

  • Inspecting HTML/CSS rendering of emails and testing mobile responsiveness.

  • Checking attachments and HTTP/SMTP headers.

:glowing_star: Why is this app a great fit for YunoHost?

Mailpit’s architecture aligns perfectly with YunoHost’s philosophy:

  • Ultra-lightweight: Written in Go, it’s a single binary with a minimal RAM and CPU footprint.

  • Database-free: It stores intercepted messages in memory or in a standalone temporary file.

  • Zero conflicts: By default, it listens on dedicated ports (1025 for SMTP, 8025 for the UI), meaning it won’t step on the toes of YunoHost’s native Postfix installation.

  • SSOwat Security: The web UI can be completely locked behind the YunoHost login portal, ensuring you are the only one who can see the intercepted emails.

:package: Package overview

This package was built following YunoHost’s standards and bash helpers.

How to test it?

The package repository is available here: https://github.com/patou/mailpit_ynh

You can test the installation directly from your command line via SSH:

Bash

sudo yunohost app install https://github.com/patou/mailpit_ynh

Next steps & Feedback

The package is fully functional and runs flawlessly on my staging instance (specifically paired with a WordPress setup). I would love to get your feedback and see tests on different architectures to iron out any potential bugs. The ultimate goal is to get it integrated into the official YunoHost app catalog.

Thanks for your feedback and happy testing!

Cheers,

Patrice

1 Like
2

Hello and welcome!

Congrats for your first packaging.

This section should be reworked to use the standard mecanism.

Once done, you can propose to transfer your app by making a pr at GitHub - YunoHost/apps: YunoHost apps catalog · GitHub so we can invite you if it fits the project.

1 Like
3

Hello,

Thanks for your message, I corrected the script for use the standard mecanism :

And I created a PR for add the application in the catalog :

Thanks

3 Likes