https://github.com/jeboehm/docker-mailserver

Docker Mailserver based on the famous ISPMail guide
https://github.com/jeboehm/docker-mailserver

alpine-linux bats clamav docker docker-compose docker-mailserver dovecot imap-server integration-tests mailserver postfix roundcube rspamd

Last synced: 6 days ago
JSON representation

Docker Mailserver based on the famous ISPMail guide

• Host: GitHub
• URL: https://github.com/jeboehm/docker-mailserver
• Owner: jeboehm
• License: mit
• Created: 2016-05-31T18:35:58.000Z (almost 10 years ago)
• Default Branch: main
• Last Pushed: 2025-04-02T11:57:06.000Z (about 1 year ago)
• Last Synced: 2025-04-02T12:25:43.723Z (about 1 year ago)
• Topics: alpine-linux, bats, clamav, docker, docker-compose, docker-mailserver, dovecot, imap-server, integration-tests, mailserver, postfix, roundcube, rspamd
• Language: Shell
• Homepage:
• Size: 758 KB
• Stars: 385
• Watchers: 12
• Forks: 98
• Open Issues: 19
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - jeboehm/docker-mailserver - Docker Mailserver based on the famous ISPMail guide (docker)

README

          
# docker-mailserver

![Logo](/docs/logo/logo.png)

`docker-mailserver` is inspired by the renowned [ISPMail guide](https://workaround.org/).

This project lets you run your own email services, giving you independence from large providers. It is a secure, customizable, and feature-rich solution for managing your email infrastructure.

Container images are built on [Alpine Linux](https://alpinelinux.org) or vendor base images and are kept lightweight.

[![Build & Tests](https://github.com/jeboehm/docker-mailserver/actions/workflows/build.yml/badge.svg)](https://github.com/jeboehm/docker-mailserver/actions/workflows/build.yml)

[![Validate Manifests](https://github.com/jeboehm/docker-mailserver/actions/workflows/test-yaml-schema.yml/badge.svg)](https://github.com/jeboehm/docker-mailserver/actions/workflows/test-yaml-schema.yml)

[![Release](https://github.com/jeboehm/docker-mailserver/actions/workflows/release.yml/badge.svg)](https://github.com/jeboehm/docker-mailserver/actions/workflows/release.yml)

[![Documentation](https://github.com/jeboehm/docker-mailserver/actions/workflows/docs.yml/badge.svg)](https://github.com/jeboehm/docker-mailserver/actions/workflows/docs.yml)

## 📚 Documentation

**Full documentation is available at: [https://jeboehm.github.io/docker-mailserver/](https://jeboehm.github.io/docker-mailserver/)**

The documentation includes:

- Complete installation guides for Docker and Kubernetes

- Configuration reference for all environment variables

- Deployment examples and recipes

- Architecture and development guides

## Features

- Secure email protocols: POP3, IMAP, and SMTP with user authentication

- Web-based management interface for account, domain, and alias administration

- Integrated webmail interface

- DKIM message signing and spam filtering with Rspamd

- Real-time spam prevention using RBLs (Real-Time Blackhole Lists)

- Fetchmail integration for external mail retrieval

- Quota management, catch-all addresses, and send-only accounts

- Restriction of sender addresses for enhanced security

- Full-text search and enforced TLS

- DNS Validation Wizard for all mail related DNS records

- Generates configuration profiles for iOS and macOS devices

- Supports assisted client configuration in Outlook and Thunderbird

- Continuous health monitoring

See the [documentation](https://jeboehm.github.io/docker-mailserver/) for a complete feature list.

## Quick start

```bash

# 1. Clone the repository or download a release

git clone https://github.com/jeboehm/docker-mailserver.git

cd docker-mailserver

# 2. Copy and edit the environment file (set passwords for MYSQL_PASSWORD,

#    REDIS_PASSWORD, CONTROLLER_PASSWORD, and DOVEADM_API_KEY)

cp .env.dist .env

# 3. Pull images and start services

bin/production.sh pull

bin/production.sh up -d --wait

# 4. Create the first email account and admin user

bin/production.sh run --rm web setup.sh

```

After setup, access the management interface at

`http://127.0.0.1:81/manager/` and webmail at `http://127.0.0.1:81/webmail/`.

For a complete walkthrough, see the

[Getting Started tutorial](docs/tutorials/getting-started.md).

## Setup

`docker-mailserver` can be set up using Docker or Kubernetes.

For detailed installation instructions, see the

[Installation Guide](docs/installation.md).

## Screenshots

### Dashboard

![Dashboard](docs/images/admin/dashboard.png)

### User management

![User List](docs/images/admin/user_list.png)

![User Edit](docs/images/admin/user_edit.png)

### DKIM setup

![DKIM setup](docs/images/admin/dkim_edit.png)

### DNS Validation Wizard

![DNS Validation Wizard](docs/images/admin/dns_wizard.png)

## Links

- [Documentation](https://jeboehm.github.io/docker-mailserver/) - Complete documentation and guides

- [Issues](https://github.com/jeboehm/docker-mailserver/issues) - Report bugs and request features

- [Releases](https://github.com/jeboehm/docker-mailserver/releases) - Release notes and changelog

- Container Images:

  - [GitHub Container Registry](https://github.com/jeboehm?tab=packages&repo_name=docker-mailserver)

  - [Docker Hub](https://hub.docker.com/u/jeboehm?page=1&search=mailserver)