Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Mailoney

github.com

  • Free plan
  • Windows
  • Linux
  • Self-hosted
7.1 Club score Visit github.com

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.