67 lines
2.5 KiB
Markdown
67 lines
2.5 KiB
Markdown
|
docker-made-special-mail
|
||
|
|
==========
|
||
|
|
|
||
|
|
Based on https://github.com/lava/dockermail
|
||
|
|
|
||
|
|
A secure, minimal-configuration mail server in a docker container.
|
||
|
|
|
||
|
|
This repository is tailored to small private servers, where you own some domain(s) and
|
||
|
|
want to receive the mail for and send mail from this domain:
|
||
|
|
|
||
|
|
The SMTP and IMAP server. This container uses postfix as MTA and dovecot as IMAP server.
|
||
|
|
All incoming mail to your own domains is accepted. For outgoing mail, only authenticated
|
||
|
|
(logged in with username and password) clients can send messages via STARTTLS on port 587.
|
||
|
|
In theory it works with all mail clients, but it was only tested with Thunderbird.
|
||
|
|
|
||
|
|
|
||
|
|
Setup
|
||
|
|
=====
|
||
|
|
Create 2 folders: one for mail configuration (`/opt/dockermail/settings`), another for mail storage (`/opt/dockermail/vmail`).
|
||
|
|
|
||
|
|
|
||
|
|
1) Add all domains you want to receive mail for to the file `/opt/dockermail/settings/domains`, like this:
|
||
|
|
|
||
|
|
example.org
|
||
|
|
example.net
|
||
|
|
|
||
|
|
2) Add user aliases to the file `/opt/dockermail/settings/aliases`, like
|
||
|
|
|
||
|
|
johndoe@example.org john.doe@example.org
|
||
|
|
john.doe@example.org john.doe@example.org
|
||
|
|
admin@forum.example.org forum-admin@example.org
|
||
|
|
@example.net catch-all@example.net
|
||
|
|
|
||
|
|
An IMAP mail account is created for each entry on the right hand side.
|
||
|
|
Every mail sent to one of the addresses in the left column will
|
||
|
|
be delivered to the corresponding account in the right column.
|
||
|
|
|
||
|
|
3) Add user passwords to the file `/opt/dockermail/settings/passwords` like this
|
||
|
|
|
||
|
|
john.doe@example.org:{PLAIN}password123
|
||
|
|
admin@example.org:{SHA256-CRYPT}$5$ojXGqoxOAygN91er$VQD/8dDyCYOaLl2yLJlRFXgl.NSrB3seZGXBRMdZAr6
|
||
|
|
|
||
|
|
To get the hash values, you can either install dovecot locally or use lxc-attach to attach to the running
|
||
|
|
container and run `doveadm pw -s <scheme-name>` inside.
|
||
|
|
|
||
|
|
4) Build container
|
||
|
|
|
||
|
|
make
|
||
|
|
|
||
|
|
5) Run container and map ports 25 and 143 from the host to the container.
|
||
|
|
To store your mail outside the container, map `/opt/dockermail/vmail/` to
|
||
|
|
a directory on your host. (This is recommended, otherwise
|
||
|
|
you have to remember to backup your mail when you want to restart the container)
|
||
|
|
|
||
|
|
`docker run -d -p 25:25 -p 587:587 -p 143:143 -v /opt/dockermail/settings:/mail_settings -v /opt/dockermail/vmail:/vmail dovecot_made_special/2.1.7`
|
||
|
|
|
||
|
|
6) Enjoy.
|
||
|
|
|
||
|
|
|
||
|
|
Known issues / Todo / Wishlist
|
||
|
|
==============================
|
||
|
|
- HELO isn't set correctly, which can lead to problems with outgoing mail on some servers
|
||
|
|
|
||
|
|
- It would be nice to have a way of catching mail to all subdomains.
|
||
|
|
|
||
|
|
Patches welcome!
|