Katzenpost is still alpha. DO NOT DEPEND ON IT FOR STRONG SECURITY OR ANONYMITY. This playground does not provide any anonymity whatsoever.
This release of the Katzenpost mailproxy is to be used with our public test mix network. Furthermore you should expect us to remove this demo service when our testing period is over at some arbitrary time in the future.
Please consult the Katzenpost Handbook for more information: https://katzenpost.mixnetworks.org/docs/handbook/
Install the latest github release of this software that is suitable to your operating system and hardware architecture, found here:
Register your account on the mix network:
mailproxy -r -account alice
The above example creates the "alice" user on the "idefix" provider and is therefore addressed as
This registration process uses HTTPS without Tor by default. If you already have Tor on your system you can register using our onion service like this:
mailproxy -r -account alice -onion -torSocksAddr 127.0.0.1:9050
Or if you run the Tor Browser Bundle with the default Tor setup then simply:
mailproxy -r -account alice -onion
The above command should have printed "Success" and created a ~/.mailproxy directory containing various coniguration files including key material. You will now be able to run mailproxy like so:
mailproxy -f ~/.mailproxy/mailproxy.toml
Configure your e-mail client to use mailproxy. That is to say, mailproxy exposes POP3 and SMTP services which your e-mail client should be configured to use:
POP3 at 127.0.0.1 on port 2524 (l: alice@idefix, any password) SMTP at 127.0.0.1 on port 2525
Here's one possible solution:
sudo apt install thunderbird
Launch thunderbird and go to the Edit menu:
- select Account Settings
- click on the
Account Actionsdrop down menu and select
Add Mail Account. After clicking
OKyou should be presented with a configuration window that lets you specify incoming and outgoing mail settings. Click the drop down menu for incoming and select
POP3. Set the POP3 server hostname to
127.0.0.1and set the POP3 port to 2524. Next set the SMTP hostname to
127.0.0.1and the SMTP port number to 2525. Select
Nonefor both drop down menus that by default specify TLS is used. Set POP3 authentication to
Normal Passwordand SMTP authentication to
No Authentication. POP3 authentication username must be set to
aliceis replaced with your username that you registered with. The password can be set to anything.
Alternatively, for quick testing, you can use command line clients like curl to fetch and display mail (
curl --user alice@idefix:somepassword pop3://127.0.0.1:2524/) and swaks for sending mail (
swaks --from alice@idefix --to bob@ramix --server 127.0.0.1:2525).
For more joy, change the log level from
DEBUG in your
Please do feel free to contact us for question or assistance.
- You can reach me directly via e-mail: email@example.com
- I'm also available on IRC, my nick is
dawuudin the #katzenpost channel on the OFTC network.
- We've also got a mailing list here: https://lists.mixnetworks.org/listinfo/katzenpost
AGPL: see LICENSE file for details.
This project has received funding from the European Union’s Horizon 2020 research and innovation programme under the Grant Agreement No 653497, Privacy and Accountability in Networks via Optimized Randomized Mix-nets (Panoramix).