Releases: foxcpp/maddy
Release list
maddy 0.2
Stability: This version is believed to be stable enough for use in use
non-critical deployments. Database structure for sql (imapsql) module is
compatible with 0.1. Configuration requires some changes.
Incompatible changes & migration notes
-
alias_fileis replaced with genericreplace_rcptmodule that can use any "table"-like structure for lookups.
Migration: Replacealias_file /etc/maddy/aliaseswithreplace_rcpt file_table /etc/maddy/aliases. -
replace_rcptnow relies on tables to handle regexp and static replacements.
Migration: Replacereplace_rcpt postmaster postmaster@$(primary_domain)
withreplace_rcpt static { entry postmaster postmaster@$(primary_domain).
Replacereplace_rcpt "(.+)\+(.+)@(.+)" "$1@$3"with
replace_rcpt regexp "(.+)\+(.+)@(.+)" "$1@$3". -
Module
sqlis renamed toimapsql. Change its name in the
configuration block definition forlocal_mailboxes/local_authdb. -
Configuration parser now requires a new line after
}closing the block.
New features
-
Authentication code is refined and generalized. It permits the implementation
of additional more complex SASL mechanisms such as TLS client certificate
authentication and OAuth2 support. These are not implemented in 0.2 though.
What is currently accessible is the ability to use multiple password-based
authentication providers to allow user login based on any match from any
credentials store configured. -
Generic Postfix-like string lookup abstraction is introduced. Alias rewriting
is updated to use. Additionally, it is possible to use it for password-based
authentication now. Currently implemented "tables" are:identity(returns
the lookup key),dummy(empty table),sql_table(returns the result of
a SQL query),static(hardcoded mapping),regexp(Regular
Expression-based rewrite of lookup key). -
sign_dkimmodule now supports multiple domains in a single configuration,
avoiding the need for complex dispatching. -
maddy -voutput now includes compile-time defaults forstate_dir,
runtime_dirand configuration path. -
build.shscript can now customize default values forstate_dirand
runtime_dir.
Bug fixes
- Fix race in
file_tablereload test (a91d8c2) - Fix misuse of TriesCount in queue (ceda725)
- Fix queue retry delay calculation (4b3e7ce)
Build artifacts
| Artifact | SHA-256 |
|---|---|
| maddy executable (Linux, x86_64, musl) | b9a5c29c50575f63e3b3de7b8ad0380917ff568560da3860580186c53be89304 |
| maddyctl executable (Linux, x86_64, musl) | 7bc9ac4cf62e8317a2ef0fa6ff3a8cde6877a2f972c94c1bcbd8f8f0bd4c148e |
| Full Zstd tarball (Linux, x86_64, musl) | 154617ed5a9314947c67272edc2a884e0df4664e537816ae6da832f30e00d5dc |
| Sourec code tarball | 6f3799d8158d5b9e4625084ab6548fc70c98acdc0234e2acac7e05e553753753 |
🔒 Attached tarballs are signed using PGP key 3197 BBD9 5137 E682 A597 17B4 34BB 2007 0813 96F4
Build artifacts are produced using the same environment as 0.1.
maddy 0.1.1
This release includes no server code changes.
Known issues
-
Delay between outbound delivery attempts is improperly calculated and has no effect.
Fixed on development branch. Set low outbound rate limit as a workaround for 0.1:limits outbound_limits { destination rate 1 1m } -
Outbound delivery will be attempted more than allowed by
max_tries(by 1).
Fixed on development branch. -
build.sh script bundled with 0.1 fails if the system Go toolchain lacks the patch version number (e.g. 1.14).
Fixed on development branch. The fixed version is uploaded to foxcpp.dev.
It is possible to install the in-development version by adding --gitversion flag to the build.sh script invocation:
curl 'https://foxcpp.dev/maddy/build.sh' | bash /dev/stdin --gitversion dev
Change log
Documentation
- Mention prebuilt binaries in the setup tutorial
- Be more specific about build.sh dependencies
- Remove "in early development" disclaimers
- Several minor edits (8f1d572)
Build script (build.sh)
- Use absolute path to the Go toolchain in PATH
- Check GOMOD value correctly
- Remove wget dependency
Build artifacts
| Artifact | SHA-256 |
|---|---|
| maddy executable (Linux, x86_64, musl) | dc7db76d9adba8c4a60893534eb41fb0941717f53954f87f70a5066fc43cc207 |
| maddyctl executable (Linux, x86_64, musl) | ffbcc615d343af1196635aac5e229c8e6f9bf5459eabfeae8cd2404c1ec103e3 |
| Full Zstd tarball (Linux, x86_64, musl) | 4380a2eda129987333db3fd2b4e493de62200aa4f717ea8f67789da4cb21472f |
| Source code tarball | bf155f17eda6df20b435ba6e7a2ffce773b146e2a8b9eb8bc2c7d2a02176a8db |
🔒 Attached tarballs are signed using PGP key 3197 BBD9 5137 E682 A597 17B4 34BB 2007 0813 96F4
Build environment is the same as the previous release (0.1).
maddy 0.1
Stability: This version is believed to be stable enough for use in use non-critical deployments. Backward compatibility for database structures and configuration syntax is not promised but will be maintained if possible.
Implemented features
- IMAP4rev1 (RFC 3501) server implementation with some basic extensions
- SMTP (RFC 5321) server implementation with per-source, per-destination delivery and filtering support
- Experimental local storage backend & IMAP index based on relational DB
- Sender authentication methods for inbound messages: DKIM, DMARC, SPF
- Remote server authentication methods for outbound messages: MTA-STS, DANE, DNSSEC-aware resolver, STARTTLS Everywhere rule-set support
- PAM-based user authentication (not used by default)
In the end, it is not very flexible in some corners at the moment but if you just want a generic mail server set-up, it will not be a big trouble.
Known issues
- IMAP sequence numbers are not properly synchronized, making concurrent mailbox access potentially unsafe, though the chance of actual data damage is pretty small. See issue #188 for details.
- Support for IP literals in e-mail addresses is disabled. Attempt to use them will result in a delivery error.
Build artifacts
| Artifact | SHA-256 |
|---|---|
| maddy executable (Linux, x86_64, musl) | bfcb649ca9586f190d30933174d4b5770f1b75f541c13c94d5458cb7578f9073 |
| maddyctl executable (Linux, x86_64, musl) | 8e97306825cd0d1e0b2e5867327640a1dbfa6590e1451d2a9e7ebfc932fe53d2 |
| Full Zstd tarball (Linux, x86_64, musl) | 51cc45067a99d3cfb04d72bdfde5f99e2a699b04d495f85f68b1a2894e0b41d1 |
🔒 Attached tarballs are signed using PGP key 3197 BBD9 5137 E682 A597 17B4 34BB 2007 0813 96F4
Note: Provided binaries do not include support for PAM authentication as it depends on system libraries in ways that are problematic to make portable. For system account authentication, you can use shadow module that reads /etc/shadow directly or maddy-pam-helper (install it into /usr/local/lib/maddy).
Attached tarballs include complete root prefix for Linux so you can just extract contents into the root directory to install maddy if you do not want to build it from source for whatever reason.
Build environment information:
- Distribution: Alpine Linux 3.11.3
- GCC: 9.1.0
- Go: 1.13.4
- musl-libc: 1.1.24
Utilities and all binaries used to build the tarball can be found here: https://foxcpp.dev/maddy-repro/. In theory it should be possible to recreate the exactly same build output using them.