gomailserver

gomailserver

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.

Installation

Quick Install (Linux)

Debian / Ubuntu (.deb)

# 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

RHEL / Fedora / CentOS (.rpm)

# 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

Alpine Linux (.apk)

# 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

Docker

# 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:latest

Binary Download

Download pre-built binaries for your platform from the Releases page:

# 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/

Build from Source

# 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

Quick Start

1. Copy and edit the configuration file

   sudo cp /usr/share/gomailserver/.env.example /etc/gomailserver/.env
   sudo nano /etc/gomailserver/.env
   

2. Configure your domain

   SERVER_HOSTNAME=mail.example.com
   SERVER_DOMAIN=example.com
   

3. Start the service

   sudo systemctl start gomailserver
   sudo systemctl status gomailserver
   

4. Access the web interface

   Open http://your-server:8980 in your browser.

Ports

Features

Core Mail Services

• 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

Security

• 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

Administration

• Web Interface - Modern, responsive admin panel
• RESTful API - Full programmatic access
• Systemd Integration - Service management
• SQLite/PostgreSQL - Flexible database options

Configuration

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

Documentation

• Installation Guide - Detailed installation instructions
• Release Workflow - CI/CD and release process
• API Documentation - REST API reference
• TODO - Roadmap and planned features

Contributing

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 version

License

This project is licensed under the GNU Affero General Public License v3.0.

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions