Maildrop

Maildrop is a self hostable and easy to use disposable email service that allows you to receive emails on a random email address on your domain.

https://haileyy.dev - Hosted instance

App Features

Use cases

• Signing up to services without using your real email address
• Easily creating multiple accounts on services

Features

• Random email generation
• Use custom emails
• Support for password protected inboxes
• Easy setup

Running the application

Prerequisites

• Python 3
• pip

Installation and running

1. Clone the repository

   git clone https://github.com/haileyydev/maildrop.git
   cd maildrop

2. Create a venv and activate it

   python -m venv venv
   source venv/bin/activate

3. Install the requirements

   pip install -r requirements.txt

4. Run the application

   sudo python app.py

The application must be run as root for the SMTP server to work

Connecting to your domain

1. Ensure port 25 is open as this is the port the email server uses. Some ISPs block this so you may need to use a tunnel or host maildrop in the cloud.
2. Edit your domains dns settings and create an A record pointing to your public IP.
3. Edit your domains dns settings and create an MX record pointing to the domain you made your A record on.
4. Edit .env and change the domain to your domain.

Running with docker

sudo docker run \
  -d \
  --restart unless-stopped \
  --name maildrop \
  -p 5000:5000 \
  -p 25:25 \
  -e DOMAIN="yourdomain.com" \
  haileyydev/maildrop:latest  

Replace yourdomain.com with your domain.