2021-01-16 10:16:05 +01:00
# Docker Mailserver
2016-06-25 10:57:46 +02:00
2021-04-01 22:44:31 +02:00
[![ci::status]][ci::github] [![docker::pulls]][docker::hub] [![documentation::badge]][documentation::web]
2020-12-22 11:08:50 +01:00
2022-12-24 02:32:06 +13:00
[ci::status]: https://img.shields.io/github/actions/workflow/status/docker-mailserver/docker-mailserver/default_on_push.yml?branch=master& color=blue& label=CI& logo=github& logoColor=white& style=for-the-badge
2021-01-16 10:16:05 +01:00
[ci::github]: https://github.com/docker-mailserver/docker-mailserver/actions
2024-01-28 01:51:37 +13:00
[docker::pulls]: https://img.shields.io/docker/pulls/mailserver/docker-mailserver.svg?style=for-the-badge& logo=docker& logoColor=white& color=blue
2021-01-16 10:16:05 +01:00
[docker::hub]: https://hub.docker.com/r/mailserver/docker-mailserver/
2024-01-28 01:51:37 +13:00
[documentation::badge]: https://img.shields.io/badge/DOCUMENTATION-GH%20PAGES-0078D4?style=for-the-badge& logo=googledocs& logoColor=white
2023-03-22 03:43:10 -07:00
[documentation::web]: https://docker-mailserver.github.io/docker-mailserver/latest/
2020-12-19 13:17:48 +01:00
2023-02-19 13:25:14 +01:00
## :page_with_curl: About
2022-02-23 18:22:44 +01:00
2024-01-28 01:51:37 +13:00
A production-ready fullstack but simple containerized mail server (SMTP, IMAP, LDAP, Anti-spam, Anti-virus, etc.).
- Only configuration files, no SQL database. Keep it simple and versioned. Easy to deploy and upgrade.
- Originally created by [@tomav ](https://github.com/tomav ), this project is now maintained by volunteers since January 2021.
2015-03-28 16:44:40 +01:00
2024-01-28 01:51:37 +13:00
## <!-- Adds a thin line break separator style -->
2020-09-09 17:19:48 +02:00
2024-01-28 01:51:37 +13:00
> [!TIP]
> Be sure to read [our documentation][documentation::web]. It provides guidance on initial setup of your mail server.
2023-02-19 13:25:14 +01:00
2024-01-28 01:51:37 +13:00
> [!IMPORTANT]
> If you have issues, please search through [the documentation][documentation::web] **for your version** before opening an issue.
>
> The issue tracker is for issues, not for personal support.
> Make sure the version of the documentation matches the image version you're using!
2023-02-19 13:25:14 +01:00
## :link: Links to Useful Resources
2023-03-22 03:43:10 -07:00
1. [FAQ ](https://docker-mailserver.github.io/docker-mailserver/latest/faq/ )
2. [Usage ](https://docker-mailserver.github.io/docker-mailserver/latest/usage/ )
3. [Examples ](https://docker-mailserver.github.io/docker-mailserver/latest/examples/tutorials/basic-installation/ )
4. [Issues and Contributing ](https://docker-mailserver.github.io/docker-mailserver/latest/contributing/issues-and-pull-requests/ )
2023-02-19 13:25:14 +01:00
5. [Release Notes ](./CHANGELOG.md )
2023-03-22 03:43:10 -07:00
6. [Environment Variables ](https://docker-mailserver.github.io/docker-mailserver/latest/config/environment/ )
7. [Updating ](https://docker-mailserver.github.io/docker-mailserver/latest/faq/#how-do-i-update-dms )
2020-03-16 18:38:28 +01:00
2023-02-19 13:25:14 +01:00
## :package: Included Services
2015-03-29 14:07:56 +02:00
2023-04-08 11:54:16 +02:00
- [Postfix ](http://www.postfix.org ) with SMTP or LDAP authentication and support for [extension delimiters ](https://docker-mailserver.github.io/docker-mailserver/latest/config/user-management/aliases/#address-tags-extension-delimiters-an-alternative-to-aliases )
2023-03-22 03:43:10 -07:00
- [Dovecot ](https://www.dovecot.org ) with SASL, IMAP, POP3, LDAP, [basic Sieve support ](https://docker-mailserver.github.io/docker-mailserver/latest/config/advanced/mail-sieve ) and [quotas ](https://docker-mailserver.github.io/docker-mailserver/latest/config/user-management/accounts#notes )
2023-02-19 12:36:43 +01:00
- [Rspamd ](https://rspamd.com/ )
2019-08-31 09:15:42 +02:00
- [Amavis ](https://www.amavis.org/ )
2021-03-28 22:07:52 +02:00
- [SpamAssassin ](http://spamassassin.apache.org/ ) supporting custom rules
2019-08-31 09:15:42 +02:00
- [ClamAV ](https://www.clamav.net/ ) with automatic updates
2023-02-19 13:25:14 +01:00
- [OpenDKIM ](http://www.opendkim.org ) & [OpenDMARC ](https://github.com/trusteddomainproject/OpenDMARC )
2019-08-31 09:15:42 +02:00
- [Fail2ban ](https://www.fail2ban.org/wiki/index.php/Main_Page )
- [Fetchmail ](http://www.fetchmail.info/fetchmail-man.html )
2023-05-23 16:25:08 +01:00
- [Getmail6 ](https://getmail6.org/documentation.html )
2019-08-31 09:15:42 +02:00
- [Postscreen ](http://www.postfix.org/POSTSCREEN_README.html )
- [Postgrey ](https://postgrey.schweikert.ch/ )
2023-02-19 13:25:14 +01:00
- Support for [LetsEncrypt ](https://letsencrypt.org/ ), manual and self-signed certificates
2023-03-22 03:43:10 -07:00
- A [setup script ](https://docker-mailserver.github.io/docker-mailserver/latest/config/setup.sh ) for easy configuration and maintenance
2023-02-19 13:25:14 +01:00
- SASLauthd with LDAP authentication
2024-01-12 20:45:14 +00:00
- OAuth2 authentication (_via `XOAUTH2` or `OAUTHBEARER` SASL mechanisms_)