Mailoney
github.com
- Free plan
- Windows
- Linux
- Self-hosted
What Mailoney is
Mailoney is a free, open-source, self-hosted SMTP honeypot for detecting and logging unauthorized access attempts, credential harvesting, and other SMTP attacks. It simulates a vulnerable mail server, accepts connections on port 25, and records authentication attempts and credentials. Session data can be stored in SQLite, PostgreSQL, or MySQL/MariaDB, or the database can be disabled for event-only logging; PostgreSQL is recommended for production. Mailoney emits JSON Lines events for log shippers, with documented connections to SIEM, ELK Stack, and Loki. An optional Prometheus endpoint reports connection, session, credential, command, and duration metrics. Captured email bodies are discarded by default, while `MAILONEY_MAIL_DIR` enables disk storage. STARTTLS works when a certificate and private key are configured, with TLS 1.2 minimum. Docker, Docker Compose, and Python installation paths are provided for Linux and Windows. Version 2.1.0 adds destination IP and port logging.
Who it suits
Mailoney suits security teams and administrators who need a controlled SMTP decoy for observing attacks. It is intended for self-hosted deployments with careful privilege and firewall controls.
Good to know, and what to watch
- Captures SMTP credentials and authentication attempts
- Supports SQLite, PostgreSQL, and MySQL/MariaDB
- JSON Lines output supports log shippers
- Optional Prometheus metrics endpoint
- Free MIT-licensed open source
- Unauthenticated metrics can reveal the honeypot
- Captured email bodies are discarded by default
- Requires controlled deployment and firewall configuration
- No built-in REST API is described
The verdict
Mailoney provides a focused SMTP decoy with several storage and logging choices. Its self-hosted design and exposed metrics require disciplined network isolation and configuration.
What the maker publishes
- API
- The README suggests extending Mailoney to provide a REST API; it does not describe a built-in API. source
- Database
- Session data can be stored in SQLite, PostgreSQL, or MySQL/MariaDB; PostgreSQL is recommended for production. source
- Deployment
- The project provides a Docker image and Docker Compose instructions, as well as local installation instructions using Python. source
- Deployment
- The project documents Docker and Docker Compose deployment, plus local installation from the Python package source. source
- Latest release
- The releases page lists version 2.1.0 and says it added destination IP and port logging for SMTP sessions. source
- License
- Mailoney is distributed under the MIT License, which grants permission to use, copy, modify, and distribute the software free of charge. source
- License
- The repository identifies Mailoney as MIT-licensed. source
- Log forwarding
- Mailoney can emit JSON Lines events for log shippers and describes forwarding or connecting collected data to SIEM and other security tools. source
- Log integrations
- JSON Lines event output can be used with log shippers, and the README describes shipping logs to SIEM, ELK Stack, or Loki. source
- Maker
- The GitHub profile identifies the maintainer as Brandon E. and describes his focus as cloud and container security. source
- Message retention
- Captured email bodies are discarded by default; setting MAILONEY_MAIL_DIR opts in to writing them to disk. source
- Message retention
- Captured message bodies are discarded by default; setting MAILONEY_MAIL_DIR opts in to saving them as .eml files. source
- Metrics exposure
- The README warns that the unauthenticated metrics endpoint can identify the software as a honeypot and recommends keeping it off the internet. source
- Metrics exposure
- The unauthenticated metrics endpoint binds to loopback by default, and the project warns that exposing it can reveal the software name and version. source
- Prometheus
- An optional Prometheus metrics endpoint reports connection, session, credential, command, and duration metrics. source
- Prometheus
- An optional Prometheus /metrics endpoint exposes SMTP connection, session, credential, command, and duration metrics. source
- Purpose
- Mailoney is a low-interaction SMTP honeypot that simulates a vulnerable mail server to detect and log unauthorized access attempts, credential harvesting, and other SMTP attacks. source
- Purpose
- Mailoney is a low-interaction SMTP honeypot that simulates a vulnerable mail server to detect and log unauthorized access attempts, credential harvesting, and other SMTP-based attacks. source
- Security guidance
- The README advises deploying Mailoney in a controlled environment, using limited privileges, and configuring a firewall. source
- Security guidance
- The project advises deploying the honeypot in a controlled environment, limiting privileges, and configuring a firewall to prevent misuse. source
- SMTP capture
- It accepts SMTP connections on port 25 and captures authentication attempts and credentials. source
- SMTP listener
- It simulates an SMTP server accepting connections on port 25 and captures authentication attempts and credentials. source
- STARTTLS
- Mailoney supports SMTP STARTTLS when a certificate and matching private key are configured, with TLS 1.2 as the minimum handshake version. source
- Storage
- Session data can be stored in SQLite, PostgreSQL, or MySQL/MariaDB, and the database can be disabled for event-logging-only operation. source
Checked against the maker's pages on 7 Oct 2026.