Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
An open-source mail server and email marketing platform in one Compose stack. Postfix, Dovecot and Rspamd handle sending and receiving, Roundcube provides webmail, and a Go and Vue admin panel manages domains, mailboxes, contacts, campaigns and analytics, backed by PostgreSQL and Redis. Setup expects you to add a domain and publish DNS records (A, MX, SPF, DMARC and DKIM) before mail flows.
Runs on a VPS from $12/mo (Kamatera 4GB, 4 GB RAM) · prices checked Nov 2026
Fits home hardware (452 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick BillionMail when you want to run your own mail server and your own newsletter tool as one package instead of renting an email service. Its Compose file starts Postfix, Dovecot and Rspamd for sending and receiving, Roundcube as webmail, PostgreSQL and Redis, and a Go and Vue admin panel for domains, mailboxes, contacts and campaigns. It is AGPL-3.0 and comes from the aaPanel team. Our snippet runs `billionmail/core:4.9.5` (pushed to Docker Hub 2026-06-11) with the configuration files from upstream commit `fc36c76`, which pins `4.9.3`, so we bumped that one tag. It does the configuration part of `install.sh` without the prompts: random admin name, password and panel path in `.env`, and a fresh self-signed certificate. It does not touch your firewall or install the `bm` command; run `bash bm.sh` from the project directory instead. The project's docs list a minimum of 1 CPU core, 1 GB of RAM and 20 GB of disk; our 2048 MB floor is our own, higher estimate for seven containers. In the catalog, listmonk, Keila and phpList send through an SMTP server or provider you configure, and Mautic is a marketing-automation suite; BillionMail is the one that also ships the mail server, which brings DNS records, deliverability and port 25 into your job.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# BillionMail — mail server and email marketing platform — adapted from the project's docker-compose.yml and install.sh at upstream commit fc36c76 (dev, 2026-06-11), core image bumped from 4.9.3 to 4.9.5
# Changed from upstream: install.sh replaced by its .env and certificate steps (generated .env, fresh self-signed certificate); admin user, panel path and passwords are random and stored in .env; no domain or DNS needed to start
mkdir billionmail && cd billionmail
git init -q . && git remote add origin https://github.com/Billionmail/BillionMail.git && git fetch -q --depth 1 origin fc36c76c050c3775c5e899faf7403cf0262d2744 && git checkout -q FETCH_HEAD
sed -i 's#billionmail/core:4.9.3#billionmail/core:4.9.5#' docker-compose.yml
cat > .env <<EOF
ADMIN_USERNAME=$(openssl rand -hex 4)
ADMIN_PASSWORD=$(openssl rand -hex 8)
SafePath=$(openssl rand -hex 4)
BILLIONMAIL_HOSTNAME=mail.example.com
DBNAME=billionmail
DBUSER=billionmail
DBPASS=$(openssl rand -hex 16)
REDISPASS=$(openssl rand -hex 16)
SMTP_PORT=25
SMTPS_PORT=465
SUBMISSION_PORT=587
IMAP_PORT=143
IMAPS_PORT=993
POP_PORT=110
POPS_PORT=995
REDIS_PORT=127.0.0.1:26379
SQL_PORT=127.0.0.1:25432
HTTP_PORT=80
HTTPS_PORT=443
WEB_BASE_PATH=
AAPANEL_SSO_SECRET=
TZ=Etc/UTC
IPV4_NETWORK=172.66.1
FAIL2BAN_INIT=y
RETENTION_DAYS=7
EOF
openssl genrsa -out ssl-self-signed/key.pem 2048
openssl req -x509 -new -nodes -key ssl-self-signed/key.pem -sha256 -days 3650 -out ssl-self-signed/cert.pem -subj "/C=US/ST=State/L=City/O=mail.example.com/OU=mail.example.com/CN=*.mail.example.com"
mkdir -p ssl
cp -d -n ssl-self-signed/* ssl/
docker compose up -d
timeout 300 bash -c 'set -a; . ./.env; until curl -fsSk -o /dev/null "https://localhost/$SafePath"; do sleep 3; done'
# → https://SERVER_IP:443/SafePath (SafePath, ADMIN_USERNAME and ADMIN_PASSWORD are in .env; the certificate is self-signed; open SafePath first, since panel pages return 404 until you have visited it)BillionMail's README, Compose file and install script flag these before you rely on it:
BillionMail used 452 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 2048 MB.
The BillionMail install snippet is marked verified on Ubuntu 26.04 (Nov 2026).