OpenSource-Hub
M

Modoboa

3.5k stars·System Optimization·SHA-256 checksum verified

Modoboa is a mail hosting and management platform with a modern Web UI. It integrates with Postfix and Dovecot, provides admin panel, webmail, calendar, address book, spam protection, and more. Written in Python Django and Vue.js.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Open-source mail hosting platform with web admin panel and built-in webmail.

Core Features

  • Central admin panel for domains, mailboxes, and aliases
  • Built-in webmail, calendar, and address book
  • Per-user Sieve filters, autoreply, and traffic stats
  • Amavis antivirus and DNSBL/DMARC reputation protection
  • Modular architecture with easy extension

What It Can't Do

  • Ensure correct DNS records (MX, SPF, DKIM) are set before use, otherwise emails may be rejected. Production deployment should consider professional support or thorough testing. Use the official installer to avoid dependency issues.

Use Cases

  • Self-hosted mail server for businesses or organizations
  • Alternative to commercial email services like Gmail
  • Learning mail server administration and architecture

Detailed Introduction

Modoboa is an open-source mail hosting and management platform that provides a modern, simplified web interface. It integrates seamlessly with Postfix and Dovecot, using a central SQL database (MySQL, PostgreSQL, or SQLite). Key features include an administration panel, webmail, calendar, address book, per-user Sieve filters, autoreply, graphical traffic statistics, and reputation protection (DNSBL, DMARC). All components are modular and extendable. Built with Python Django and Vue.js, it offers an official installer for easy deployment.

Troubleshooting & FAQ (1)

Troubleshooting
Why does modoboa 1.4.2 alias import fail with 'Local recipient not found'?

A bug in modoboa 1.4.2 causes alias import to fail when the target account doesn’t exist yet. The method Alias.set_recipients() checks if the recipient exists, and if not, it throws a NotFound exception instead of creating it. This breaks imports where aliases reference accounts defined later in the same CSV file.

**Workaround**: Edit modoboa/admin/models/alias.py and comment out lines 133–139:

# if rcpt is None:
                    #     raise NotFound(
                    #         _("Local recipient {}@{} not found")
                    #         .format(local_part, domname)
                    #     )
                    # if rcpt.address == self.address:
                    #     raise Conflict

This skips the premature check and allows the import to succeed. Note that after commenting, the import will create the alias even if the target is missing—ensure your CSV lists accounts before aliases if needed.

GitHub Issue #818

Tags

mailemailhostingpostfixdovecotwebmaildjangoself-hostedadmin-panel

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Clone modoboa-installer repo (git clone https://github.com/modoboa/modoboa-installer.git)

4

Step 2: Run installer script (./run.sh --domain yourdomain.com)

5

Step 3: Follow prompts to set admin password and database, then access https://yourdomain.com

Install Guide
  1. Step 1: Clone modoboa-installer repo (git clone https://github.com/modoboa/modoboa-installer.git)
  2. Step 2: Run installer script (./run.sh --domain yourdomain.com)
  3. Step 3: Follow prompts to set admin password and database, then access https://yourdomain.com
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Stop all services (systemctl stop modoboa postfix dovecot), delete installation directory and database (drop database modoboa), remove config files under /etc/.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseGPL-2.0
Last Updated2026-06-25 14:05:28
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects