fridus/imap-devel repository overview

⁠Dockerized IMAP server#

IMAP server for debugging.

IMPORTANT: This image is ONLY for developing/debugging proposes

This docker image is based on https://github.com/tomav/docker-mailserver⁠ If you look for a docker image for production environment, then go here: https://hub.docker.com/r/tvial/docker-mailserver/⁠

This image is even simpler than tvial docker image. Includes only Postfix (SMTP) and Dovecot (IMAP) servers with one catchall mailbox [email protected] for all emails. So, it's very useful for debugging. Optionally, you can define another normal mailbox.

Every email received via SMTP will be delivered locally to [email protected], so it's safe for testing a web application sending emails with a production list of emails.

Using your favorite email client you can connect via IMAP protocol to see emails like original recipient would received them

⁠Variables

• MAILNAME: Mail domain (by default, localdomain.test)
• DEBUG_USER: User name for catchall address (by default, debug)
• MAIL_ADDRESS: Normal user mailbox email address (optional)
• MAIL_PASS: Normal user mailbox password
• RELAYHOST: disable the catchall and configure a relay
• SSL: set to no to disabled SSL (by default, required)

⁠Run container with docker compose

cp docker-compose.yml.dist docker-compose.yml

Edit docker-compose.yml

docker-compose up

Configure your email client with these parameters and test it sending any email to any email address

⁠Catch all debug mailbox

• IMAP server: imap

• IMAP encryption: SSL

• IMAP port: 993

• IMAP username: [email protected] (change example.org by your MAILNAME)

• IMAP password: debug

• SMTP server: imap

• SMTP encryption: No

• SMTP port: 25

• SMTP authentication: none

⁠Normal user mailbox (Optional)

• IMAP server: imap

• IMAP encryption: SSL

• IMAP port: 993

• IMAP username: [email protected] (change [email protected] by your MAIL_ADDRESS)

• IMAP password: pass (change pass by your MAIL_PASS)

• SMTP server: imap

• SMTP encryption: No

• SMTP port: 25

• SMTP authentication: none