Welcome to the Extended Documentation for docker-mailserver!

Please first have a look at the README.md to setup and configure this server.

This documentation provides you with advanced configuration, detailed examples, and hints.

Getting Started

1. The script setup.sh is supplied with this project. It supports you in configuring and administrating your server. Information on how to get it and how to use it is available on a dedicated page.
2. Be aware that advanced tasks may still require tweaking environment variables, reading through documentation and sometimes inspecting your running container for debugging purposes. After all, a mail server is a complex arrangement of various programs.
3. A list of all configuration options is provided in ENVIRONMENT.md. The README.md is a good starting point to understand what this image is capable of.
4. A list of all optional and automatically created configuration files and directories is available on the dedicated page.

Tip

See the FAQ for some more tips!

Important

If you'd like to change, patch or alter files or behavior of docker-mailserver, you can use a script. Just place it in the config/ folder that is created on startup and call it user-patches.sh. If you'd like to see the full documentation and an example, visit the 'Modifications via Script' page.

Contributing

We are always happy to welcome new contributors. For guidelines and entrypoints please have a look at the Contributing section.