Mailoney
github.com
What it is
Mailoney is a self-hosted SMTP honeypot for recording attempts to access a simulated vulnerable mail server. It listens on port 25 and captures 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. By default, captured email bodies are discarded. Setting MAILONEY_MAIL_DIR enables writing them to disk. Events can be emitted as JSON Lines for forwarding to log shippers and security tools, including SIEM, ELK Stack, or Loki. An optional Prometheus endpoint reports connection, session, credential, command, and duration metrics. STARTTLS is available when a certificate and matching private key are configured, with TLS 1.2 as the minimum. Deployment options include Docker, Docker Compose, or local Python installation. It supports Linux and Windows and is distributed under the MIT License. The project advises controlled deployment, limited privileges, and firewall configuration; its unauthenticated metrics endpoint should not be exposed to the internet.
Spec sheet
- 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.Read 7 Oct 2026 · github.com
- Deployment
- The project documents Docker and Docker Compose deployment, plus local installation from the Python package source.Read 7 Oct 2026 · github.com
- API
- The README suggests extending Mailoney to provide a REST API; it does not describe a built-in API.Read 4 Oct 2026 · github.com
- License
- The repository identifies Mailoney as MIT-licensed.Read 7 Oct 2026 · github.com
- Maker
- The GitHub profile identifies the maintainer as Brandon E. and describes his focus as cloud and container security.Read 7 Oct 2026 · github.com
- Database
- Session data can be stored in SQLite, PostgreSQL, or MySQL/MariaDB; PostgreSQL is recommended for production.Read 4 Oct 2026 · github.com
- Latest release
- The releases page lists version 2.1.0 and says it added destination IP and port logging for SMTP sessions.Read 7 Oct 2026 · github.com
- Log forwarding
- Mailoney can emit JSON Lines events for log shippers and describes forwarding or connecting collected data to SIEM and other security tools.Read 7 Oct 2026 · github.com
- Log integrations
- JSON Lines event output can be used with log shippers, and the README describes shipping logs to SIEM, ELK Stack, or Loki.Read 4 Oct 2026 · github.com
- Message retention
- Captured message bodies are discarded by default; setting MAILONEY_MAIL_DIR opts in to saving them as .eml files.Read 7 Oct 2026 · github.com
- 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.Read 7 Oct 2026 · github.com
- Prometheus
- An optional Prometheus /metrics endpoint exposes SMTP connection, session, credential, command, and duration metrics.Read 7 Oct 2026 · github.com
- Security guidance
- The project advises deploying the honeypot in a controlled environment, limiting privileges, and configuring a firewall to prevent misuse.Read 7 Oct 2026 · github.com
- SMTP capture
- It accepts SMTP connections on port 25 and captures authentication attempts and credentials.Read 4 Oct 2026 · github.com
- SMTP listener
- It simulates an SMTP server accepting connections on port 25 and captures authentication attempts and credentials.Read 7 Oct 2026 · github.com
- STARTTLS
- Mailoney supports SMTP STARTTLS when a certificate and matching private key are configured, with TLS 1.2 as the minimum handshake version.Read 7 Oct 2026 · github.com
- Storage
- Session data can be stored in SQLite, PostgreSQL, or MySQL/MariaDB, and the database can be disabled for event-logging-only operation.Read 7 Oct 2026 · github.com
- TLS
- The SMTP server supports STARTTLS when both a certificate and private key are configured, with a TLS 1.2 minimum.Read 4 Oct 2026 · github.com
Strong points and limits
Strong points
- Captures SMTP authentication attempts and credentials.
- Supports three database options or event-only logging.
- Emits JSON Lines events for log shippers.
- Optional Prometheus endpoint reports operational metrics.
- Offers Docker and local Python deployment.
Limits
- Metrics endpoint has no authentication.
- Captured message bodies are discarded by default.
- Requires certificate and private key for STARTTLS.
Who it suits
Mailoney suits security teams seeking to capture SMTP access and credential-harvesting attempts in a self-hosted environment. It can feed event data to log shippers and security tools.
Verdict
Mailoney provides a focused SMTP decoy with several storage and deployment choices. Its unauthenticated metrics endpoint and controlled-environment guidance are important deployment considerations.
Where Specifiction places it
- Honeypot Software#18 of 216.9