Open Trashmail

Open Trashmail is a self-hosted application that provides a temporary email solution for receiving messages. It functions as a mail server that accepts emails for any domain configured by the administrator without requiring the pre-creation of specific email addresses. This allows users to receive mail at any address on their domain instantly.

The software is deployed as a server and provides three primary methods for accessing received mail: a web interface, a JSON API, and RSS feeds. It can be run via Docker and uses a file-based storage system, meaning it does not require a separate database to operate. This architecture simplifies deployment and backup processes for the administrator.

Key features

• Python-powered SMTP server supporting any configured domain
• JSON API for programmatic email retrieval and 2FA automation
• RSS feeds for every individual email address
• Custom webhooks with per-email configuration and JSON payloads
• Web interface with dark and light mode and attachment downloads
• Support for Plaintext, STARTTLS, and TLS on connect
• File-based storage system that eliminates the need for a database
• Admin panel to view server logs and list all active accounts

The system is built using PHP and Python. It includes a variety of security and access controls, such as IPv4 and IPv6 CIDR whitelisting and password protection for the web interface and API. Administrators can configure global webhook URLs to forward all incoming mail to external projects or set up a specific admin email address to act as a catch-all for all received messages. The API provides endpoints to retrieve raw email data, download attachments with correct mime types, and manage webhook configurations programmatically.

Configuration is handled through a config.ini file or Docker environment variables. These settings allow the administrator to define the mail port, maximum attachment size, and TLS certificate paths. The web interface also includes a utility to generate random email addresses for quick use.

This tool is designed for users who need a disposable email infrastructure for testing, honeypots, or automated account verification.