mnm is not mail
The mnm project is building a legitimate replacement for email: a server (see below), a client, and a simple protocol between them.
Learn more at mnmnotmail.org.
11 December 2020 - v0.1 is released for Linux!
13 April 2019 - A private preview is now live! Contact the author if you'd like to try it.
19 August 2018 - After testing with mnm client, made a handful of fixes. Changed license to MPL.
25 September 2017 - A client application is in development.
3 August 2017 - A simulation of 1000 concurrent active clients delivers 1 million messages totaling 6.7GB in 46 minutes. It uses ~200MB RAM, <10MB disk, and minimal CPU time. Each client runs a 19-step cycle that does login, then post for two recipients (15x) or for a group of 100 (2x) every 1-30s, then logout and idle for 1-30s.
Download binary or build from source
a) Get mnm-tmtpd-linux-amd64-v0.1.0.tgz
b) Extract with
tar xzf mnm-tmtpd-linux-amd64-v0.1.0.tgz
go get github.com/networkimprov/mnm
Enable TCP+TLS with self-signed certificate
openssl ecparam -genkey -name secp384r1 -out server.key
openssl req -new -x509 -sha256 -key server.key -out server.crt -days 3650
cp mnm.conf mnm.config# edit to revise ntp.hosts and adjust listen.laddr with "host:port"
Note: On a public Internet host, port 443 will see a steady trickle of probe requests (often with malicious intent) which pollutes the mnm log. Choose a port above 1024 to avoid this.
./mnm# default port 443 may require
sudo ./mnm; logs to stdout & stderr
b) Ctrl-C to stop
./mnm >> logfile 2>&1 &# run in background, logs to end of logfile
kill -s INT <background_pid># send SIGINT signal, triggering graceful shutdown
Distribute the server address to users
=address:portfor a self-signed certificate, for example
+address:portfor a CA-issued certificate, for example
The file "mnm.config" contains a JSON object with these fields.
ntp (network time protocol) object defines:
hosts - an array of NTP servers
retries - the number of times to retry each host
listen object defines:
laddr - arguments to
net.ListenConfig.Listen(nil, net, laddr)
keyPath - arguments to
name parameter defines the server's
auth parameter defines where third party authentication is required:
0 - not supported
1 - required for registration
2 - required for registration and login (not yet implemented)
authby array defines a set of objects describing OpenID Connect providers:
label - the name of the OIDC provider/application
login - an array giving the base URL, followed by name=value request parameters, for OIDC
token - an array giving the base URL, followed by name=value request parameters, for OIDC
std - an array of name=value request parameters to append to both
keys - the URL for the public key needed to validate tokens provided by OIDC authentication
aud - expected values for claims in the
.id_token field of OIDC tokens
If the first
authby object is empty, OpenID Connect authentication is optional.
This is useful for testing.
Build & package
Assuming this repository has been obtained via
git stash # if required
git checkout <your_branch>
d) Edit kVersionDate in main.go
./pkg.sh # make release downloads
Continuous test sequence with simulated clients
./mnm 10 > /dev/null # may be 2-1000
b) ctrl-C to stop
test.json gives a sequence of requests and expected results,
which runs prior to the continuous test.
It includes invalid requests, which print messages to stderr.
- codestyle.txt: how to make Go source more clear
- qlib/: TMTP implementation
- test.json: qlib test data
- userdb.go: user & group records management
- userdb-test.go: userdb test procedure
- main.go: main(), network frontend
- mnm.conf: site-specific parameters; rename to mnm.config to enable TCP server
- mnm: the server executable
- After first run:
userdb/: user & group data
qstore/: queued messages awaiting delivery
Copyright 2020 Liam Breck
Published at https://github.com/networkimprov/mnm
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/