Skip to content
SPECIFICTION
Get listed

Mailoney

github.com

WindowsLinuxSelf-hosted
Visit github.com
Spec score 6.9 #18 of 21 in Honeypot Software

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

Alternatives to MailoneyAll alternatives →