Download MailSpoof

Choose your preferred installation method. All methods are free, open-source, and Apache-2.0 licensed.

Quick Install

The recommended method for most users. This clones the entire repository to your local machine, then runs the automated installer script which handles dependency installation, virtual environment creation, and system path setup.

bash
$ git clone https://github.com/syed-sameer-ul-hassan/MailSpoof.git
$ cd MailSpoof && bash install.sh

What this does: Downloads the source code, installs dnspython, creates a Python virtual environment, installs the mailspoof CLI wrapper in your /usr/local/bin or ~/.local/bin, and verifies the installation.

Online Install

For users who want the fastest setup without keeping the source repository. This pipes the install script directly from GitHub into bash, performing a complete installation without cloning.

bash
$ curl -fsSL https://raw.githubusercontent.com/syed-sameer-ul-hassan/MailSpoof/main/install.sh | bash

What this does: Downloads and executes install.sh directly. It creates a temporary directory, clones the repo internally, runs the installer, then cleans up the source. The CLI wrapper and dependencies remain installed.

Security Note: Piping remote scripts to bash carries inherent risk. Review the install.sh source before executing if you have concerns.

Debian Package

Build a native .deb package for Debian-based distributions. This integrates MailSpoof with your system's package manager for clean installation and uninstallation.

bash
$ make deb
$ sudo dpkg -i mailspoof-v1.1.0.deb

What this does: Compiles a Debian package from source with proper metadata, dependencies, and file manifests. dpkg -i installs it system-wide and registers it with apt for future removal.

  • Works on Debian, Ubuntu, Linux Mint, Kali Linux, and derivatives
  • Integrates with apt remove mailspoof for clean uninstallation
  • Requires dpkg-deb and make installed to build

Manual Setup

For developers or users who prefer minimal intervention. Simply install the single external dependency and run the tool directly from source without any wrapper or system integration.

bash
$ pip install dnspython
$ python3 mailspoof

What this does: Installs only the dnspython dependency via pip, then executes mailspoof as a Python script. No virtual environment, no system wrapper, no automatic updates.

  • Best for development or debugging
  • No system-wide modifications
  • Requires manual dependency management

System Requirements

MailSpoof is designed to run on a wide range of Unix-like systems with minimal overhead.

  • Python 3.8+ with venv and pip support
  • Platforms: Linux (Debian, Ubuntu, Fedora, Arch, Alpine, openSUSE), macOS, and Termux (Android)
  • Dependencies: Only external dependency is dnspython. Everything else uses the Python standard library.
  • Network: Internet access required for SMTP relay and MX record lookups during testing