HTTP basic authentication is supported using a password file.
See example-auth for an example (the password is test).
Authentication applies to all HTTP requests, including static content and API endpoints.
The password file format is:
- One user per line
username:password- Password is bcrypted
By default, a bcrypt difficulty of 4 is used to reduce page load times.
You can use a MailHog shortcut to generate a bcrypted password:
MailHog bcrypt <password>
To enable authentication, pass an -auth-file flag to MailHog:
MailHog -auth-file=docs/example-auth
This also works if you're running MailHog-UI and MailHog-Server separately:
MailHog-Server -auth-file=docs/example-auth
MailHog-UI -auth-file=docs/example-auth
Authentication has been a bit of an experiment.
The exact implementation may change over time, e.g. using sessions in the UI and tokens for the API to avoid frequently bcrypting passwords.