Archive-Team
/
docker-mailserver
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Production-ready fullstack but simple mail server (SMTP, IMAP, LDAP, Antispam, Antivirus, etc.) running inside a container.
2,590 Commits 8 Branches 30 Tags 51 MiB
Shell 96.6%
Dockerfile 2.1%
Makefile 0.5%
Python 0.3%
C++ 0.2%
Other 0.2%
Go to file
polarathene f770609a66 tests: OAuth2 - Implement coverage for `OAUTHBEARER` 
Caddyfile route for `/imap/` now accepts any subpath to support handling both `xoauth2` and `oauthbearer` subpaths.

Both SASL mechanisms represent the same information, with `XOAUTH2` being a common mechanism to encounter defined by Google, whilst `OAUTHBEARER` is the newer variant standardized by RFC 7628 but not yet as widely adopted.

The request to `/userinfo` endpoint will be the same, only the `credentials` value to be encoded differs.

Instead of repeating the block for a similar route, this difference is handled via the Caddyfile `map` directive.

We match the path context (_`/xoauth2` or `/oauthbearer`, the `/imap` prefix was stripped by `handle_path` earlier_), when there is a valid match, `sasl_mechanism` and `credentials` map vars are created and assigned to be referenced by the later `respond` directive.

---

Repeat the same test-case logic, DRY with log asserts extracted to a common function call. This should be fine as the auth method will be sufficient to match against or a common failure caught.
 		2024-01-19 18:43:19 +13:00
.github docs: misc improvements (#3773) 2024-01-16 08:38:08 +00:00
config-examples docs: Fix typos (#3443) 2023-07-27 12:24:36 +12:00
docs docs: Guidance for binding outbound SMTP with multiple interfaces available (#3465) 2024-01-19 14:58:20 +13:00
target setup/dkim: chown created dkim directories and keys to config user (#3783) 2024-01-18 10:41:55 +01:00
test tests: OAuth2 - Implement coverage for `OAUTHBEARER` 2024-01-19 18:43:19 +13:00
.all-contributorsrc Update contributors (#2143) 2021-08-28 15:23:11 +02:00
.dockerignore Update check (#1951) 2021-05-19 21:18:06 +02:00
.editorconfig ci(fix): Normalize for `.gitattributes` + improve `eclint` coverage (#3566) 2023-10-04 12:53:32 +02:00
.gitattributes ci: `.gitattributes` - Ensure `eol=lf` for shell scripts (#3755) 2024-01-08 09:34:24 +13:00
.gitignore feat: Auth - OAuth2 (Dovecot PassDB) (#3480) 2024-01-13 09:45:14 +13:00
.gitmodules removal: configomat (submodule) (#3045) 2023-02-05 12:39:05 +01:00
CHANGELOG.md docs: Guidance for binding outbound SMTP with multiple interfaces available (#3465) 2024-01-19 14:58:20 +13:00
CODE_OF_CONDUCT.md docs(fix): Update wiki references to the new docs url 2021-03-25 11:49:24 +13:00
CONTRIBUTORS.md docs: updated `CONTRIBUTORS.md` (#3777) 2024-01-14 14:08:27 +01:00
Dockerfile feat: Add MTA-STS support for outbound mail (#3592) 2024-01-13 21:37:20 +13:00
LICENSE Final Migration Step (#6) 2021-01-16 10:16:05 +01:00
Makefile ci: add `run-local-instance` target to `Makefile` (#3663) 2023-12-04 10:28:40 +13:00
README.md feat: Auth - OAuth2 (Dovecot PassDB) (#3480) 2024-01-13 09:45:14 +13:00
SECURITY.md ci/docs: add vulnerability scanning workflow & security policy (#3106) 2023-02-23 08:53:12 +01:00
VERSION release: v13.2.0 (#3746) 2024-01-04 22:14:51 +01:00
compose.yaml compose.yaml: Add comment about disabled authentication on port 25 (#3464) 2023-08-14 01:58:54 +02:00
mailserver.env fix: Revert quoting `SA_SPAM_SUBJECT` in `mailserver.env` (#3767) 2024-01-15 11:23:23 +13:00
setup.sh Change 'while' style (#3365) 2023-05-26 01:39:39 +02:00

README.md

Docker Mailserver

ci::status docker::pulls documentation::badge

📃 About

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, this project is now maintained by volunteers since January 2021.

💡 Documentation

We provide a dedicated documentation hosted on GitHub Pages. Make sure to read it as it contains all the information necessary to set up and configure your mail server. The documentation is crafted with Markdown & MkDocs Material.

💥 Issues

If you have issues, please search through the documentation 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!

🔗 Links to Useful Resources

  1. FAQ
  2. Usage
  3. Examples
  4. Issues and Contributing
  5. Release Notes
  6. Environment Variables
  7. Updating

📦 Included Services