A modern, composable, all-in-one mail server written in Go designed to replace complex mail server stacks (Postfix, Dovecot, OpenDKIM, etc.) with a single daemon.
# Download the latest release
curl -LO https://github.com/btafoya/gomailserver/releases/latest/download/gomailserver_*_amd64.deb
# Install
sudo dpkg -i gomailserver_*_amd64.deb
# Start the service
sudo systemctl enable --now gomailserver# Download the latest release
curl -LO https://github.com/btafoya/gomailserver/releases/latest/download/gomailserver_*_x86_64.rpm
# Install
sudo rpm -i gomailserver_*_x86_64.rpm
# Start the service
sudo systemctl enable --now gomailserver# Download the latest release
curl -LO https://github.com/btafoya/gomailserver/releases/latest/download/gomailserver_*_x86_64.apk
# Install
sudo apk add --allow-untrusted gomailserver_*_x86_64.apk# Pull the latest image
docker pull ghcr.io/btafoya/gomailserver:latest
# Run with default configuration
docker run -d \
--name gomailserver \
-p 25:25 \
-p 587:587 \
-p 465:465 \
-p 143:143 \
-p 993:993 \
-p 8980:8980 \
-v gomailserver-data:/var/lib/gomailserver \
-v gomailserver-config:/etc/gomailserver \
ghcr.io/btafoya/gomailserver:latestDownload pre-built binaries for your platform from the Releases page:
| Platform | Architecture | Download |
|---|---|---|
| Linux | x86_64 | gomailserver_VERSION_linux_amd64.tar.gz |
| Linux | ARM64 | gomailserver_VERSION_linux_arm64.tar.gz |
| macOS | x86_64 | gomailserver_VERSION_darwin_amd64.tar.gz |
| macOS | ARM64 (Apple Silicon) | gomailserver_VERSION_darwin_arm64.tar.gz |
| Windows | x86_64 | gomailserver_VERSION_windows_amd64.zip |
# Example: Linux x86_64
curl -LO https://github.com/btafoya/gomailserver/releases/latest/download/gomailserver_*_linux_amd64.tar.gz
tar -xzf gomailserver_*_linux_amd64.tar.gz
sudo mv gomailserver /usr/local/bin/# Clone the repository
git clone https://github.com/btafoya/gomailserver.git
cd gomailserver
# Build
make build
# Or build a static binary
make build-static
# Install system-wide
sudo make install-
Copy and edit the configuration file
sudo cp /usr/share/gomailserver/.env.example /etc/gomailserver/.env sudo nano /etc/gomailserver/.env
-
Configure your domain
SERVER_HOSTNAME=mail.example.com SERVER_DOMAIN=example.com
-
Start the service
sudo systemctl start gomailserver sudo systemctl status gomailserver
-
Access the web interface
Open
http://your-server:8980in your browser.
| Port | Protocol | Description |
|---|---|---|
| 25 | SMTP | Mail Transfer (MX) |
| 587 | SMTP | Mail Submission (STARTTLS) |
| 465 | SMTPS | Mail Submission (Implicit TLS) |
| 143 | IMAP | Mail Access |
| 993 | IMAPS | Mail Access (Implicit TLS) |
| 8980 | HTTP | Web Interface / API |
- SMTP - Send and receive mail with full MTA/MX support
- IMAP - Access mail from any client
- CalDAV - Calendar synchronization with ACL support
- CardDAV - Contact synchronization
- DKIM - DomainKeys Identified Mail signing
- SPF - Sender Policy Framework validation
- DMARC - Domain-based Message Authentication
- TLS - Automatic certificate management via Let's Encrypt
- AI-Powered Phishing Detection - Real-time threat analysis
- Web Interface - Modern, responsive admin panel
- RESTful API - Full programmatic access
- Systemd Integration - Service management
- SQLite/PostgreSQL - Flexible database options
See .env.example for a complete configuration reference.
Key environment variables:
# Server
SERVER_HOSTNAME=mail.example.com
SERVER_DOMAIN=example.com
# Database (SQLite or PostgreSQL)
DB_DRIVER=sqlite3
DB_SQLITE_PATH=/var/lib/gomailserver/mailserver.db
# SMTP
SMTP_SUBMISSION_PORT=587
SMTP_RELAY_PORT=25
SMTPS_PORT=465
# IMAP
IMAP_PORT=143
IMAPS_PORT=993
# TLS / Let's Encrypt
ACME_ENABLED=true
ACME_EMAIL=admin@example.com
# Web UI & API
WEBUI_ENABLED=true
WEBUI_PORT=8080
API_PORT=8980- Installation Guide - Detailed installation instructions
- Release Workflow - CI/CD and release process
- API Documentation - REST API reference
- TODO - Roadmap and planned features
Contributions are welcome! Please read our contributing guidelines before submitting pull requests.
# Run tests
make test
# Run linter
make lint
# Build and test locally
make build
./build/gomailserver versionThis project is licensed under the GNU Affero General Public License v3.0.
- Issues: GitHub Issues
- Discussions: GitHub Discussions