Report a Bug

Found an issue? Help us improve MailSpoof by submitting a detailed bug report.

Submit a Bug Report

Please fill out the form below with as much detail as possible. The more information you provide, the faster we can diagnose and fix the issue.

Critical — Crash or data loss
High — Major feature broken
Medium — Minor feature issue
Low — Cosmetic or UI issue
v1.1.0
v1.0.0

Daily Limit Reached

You can submit up to 3 bug reports per day. Please try again tomorrow.

Severity Levels

Critical

  • Application crash or unexpected termination
  • Data loss or corruption
  • Security vulnerability

High

  • Major feature completely non-functional
  • SMTP relay fails entirely
  • Template engine broken

Medium

  • Feature works but has significant issues
  • Workarounds exist but are inconvenient
  • Partial data loss in edge cases

Low

  • Cosmetic or UI issues
  • Typos in output or documentation
  • Minor formatting problems

Before You Report

Checklist

  • Check existing GitHub Issues to avoid duplicates
  • Ensure you're running the latest version of MailSpoof
  • Test on a clean environment if possible
  • Include clear steps to reproduce, expected vs actual behavior
  • Provide your OS, Python version, and any error messages

Creating a GitHub Issue

We use GitHub Issues to track bugs and feature requests. You can open an issue directly on our repository, or use this form above. Here's how the GitHub issue template is structured:

Issue Template Fields

  • Description — A clear description of what went wrong
  • Reproduction Steps — Step-by-step instructions to reproduce the bug
  • Expected Behavior — What you expected to happen
  • Version — Your MailSpoof version (e.g., v1.1.0)
  • Operating System — Your OS (e.g., Ubuntu 22.04, macOS 14)
  • Logs / Stack Trace — Any error output or terminal logs
  • Screenshot / Context — Images or additional information
Continue to GitHub Issues

To create an issue on GitHub:

bash
1. Visit: https://github.com/syed-sameer-ul-hassan/MailSpoof/issues
2. Click New Issue
3. Select Bug Report template
4. Fill in all required fields
5. Click Submit new issue

Other ways to report:

  • This website form (above)
  • Email: security.mailspoof@orildo.sbs
  • Security vulnerabilities: Do NOT open public issues. Email security.mailspoof@orildo.sbs directly.

Include this environment info in your report:

bash
$ mailspoof -v
$ python3 --version
$ uname -a

If applicable, include recent log output:

bash
$ cat ~/.mailspoof/audit.log | tail -n 50

Quick Checklist

  • I am using the latest version (mailspoof -v)
  • I have checked existing issues for duplicates
  • I have included reproduction steps
  • I have included my OS and Python version
  • I have attached logs if applicable
  • This is NOT a security vulnerability (email security.mailspoof@orildo.sbs for those)