Billionmail/BillionMail

DevOps & Self-hosting

Self-host a mail server and email marketing platform to send newsletters and campaigns under your own domain.

16,091
1,786
Go
AGPL-3.0
1 year old

BillionMail bundles a mail server stack with newsletter and email-marketing tools, aimed at businesses and individuals who want to send promotional, newsletter, or transactional email from their own infrastructure rather than a hosted provider. The README positions it around self-hosted control, campaign lists and tags, and tracking of delivery, opens, and clicks README.

What it does and how you use it

The advertised workflow is short: install, add a sending domain and verify its DNS records (with automatic free SSL), then compose an email, choose a list and tags, and send immediately or schedule README. RoundCube is integrated for webmail at /roundcube/, so mailbox access sits alongside the campaign tooling README. A live demo with shared credentials is provided for trying the interface before installing demo.

Sending relies on a conventional open-source mail stack — the repository topics list Postfix, Dovecot, and Rspamd — plus a Go-based management layer. A bm management script handles help, retrieving default login information, printing domain DNS records, and updating the installation README.

Installation paths

There are three documented ways in, with different prerequisites:

  • Install script: clone into /opt and run install.sh; the README claims 8 minutes from install to a successful send README.
  • Docker/Compose: copy env_init to .env and start with docker compose up -d; Docker and the Compose plugin must be installed and the .env file adjusted manually README.
  • aaPanel one-click: install via aaPanel's Docker section aaPanel.

All paths assume a server you control; the choice mainly affects how much of the environment setup (Docker, panel, or script) you delegate.

Constraints and licence

The README lists no explicit system requirements beyond the Docker note, and its performance claims ("a billion emails," "unlimited sending") are marketing statements rather than benchmark results README. Whether large-volume sending actually works depends heavily on your server, DNS reputation, and deliverability setup — none of which the README documents. Because mail delivery is reputation-sensitive, domain verification and correct DNS records are not optional steps.

The project is AGPL-3.0 licensed, which the README summarizes as free use, modification and distribution, and private use without restrictions LICENSE. For anyone embedding it in a networked service, the AGPL's copyleft obligations are worth reviewing in the actual licence text.

The docs link points to the project website for setup and compatibility details docs.

HotRepo's take

A single daily-board observation on 2026-10-31 recorded 16,077 stars (+92) [HotRepo signals]; one sample cannot show a trend. The more useful signal is fit: if you want a hosted-style email marketing tool that stays on your own server and can accept mail-server operations as part of the package, this is the intended use case. If you only want to send occasionally or have no appetite for DNS and deliverability tuning, the operational surface is large relative to the benefit.

Written by AI from the project's README, updated October 31, 2026. The project's own docs are the source of truth.