A simple smtp and webserver for throwaway email addresses
Project description
Mailbox Zero
Can't reach Inbox Zero? Just create a new one.
MailboxZero is a server that provides you an infinite number of mailboxes that you can check via a REST API.
It combines a SMTP server that accepts incoming emails and a web server that provides access to the emails over a REST API.
How to use it
mb0.wtte.ch is a demo instance of MailboxZero
- Send an email to
somerandomstring@mb0.wtte.ch
- Visit http://mb0.wtte.ch:8880/api/somerandomstring@mb0.wtte.ch for a list of messages in your mailbox
- Retrieve an individual message by visiting
http://mb0.wtte.ch:8880/api/somerandomstring@mb0.wtte.ch/<messageID>
Messages get deleted about ten minutes after arriving. You get a parsed version of the email, not the raw email. MailboxZero will show you:
- the richest body, usually the HTML version
- the simplest body, usually the plain text version
- the URLs in each body
- the headers of the email as a list of
(name, value)
pairs - the subject, from and date fields
Deploying your own instance
Quick start:
- Install Python 3.8 or newer
- Install MailboxZero
pip install -U mailboxzero
- Run
mailboxzero
asroot
.
To run an instance reachable from the public internet you need a public IP,
assign a hostname to it, and setup a MX record to point to that hostname. You
should also use something like systemd to run MailboxZero in order to limit its
privileges and not run it as root
.
Development
Setup the development dependencies with python -m pip install -U -r dev-requirements.txt
.
We use pytest
to run the tests in tests/
.
Main libraries used:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mailboxzero-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9b50003ef7664f35fe08ed3e670cc99e0c42b047c7cfcdf748a3a39ba66c05b5 |
|
MD5 | 5341aa3a403116de4c07f434d3afcd0b |
|
BLAKE2b-256 | e45234f4e852dbff3569459b4b031dc3bf6a4a628a2a799f8646eb9ea9a6bf80 |