This Docker image provides a mail transfer agent (MTA) running as a smarthost for Docker containers. The container can be used to send out e-mails from other containers.
The MTA is based on Exim4. The Image was inspired by the Docker Image from greinacker/exim4. The Docker image is based on debian:jessie.
imixs/exim4 provides the following environment variables
Follow the Docker installation instructions for your host system.
The container can be started in background as an demon. You can start an instance with the command:
docker run --name="smarthost" -d \
-e EXIM_SMARTHOST="target.mail.server.example:25" \
-e EXIM_PASSWORD="target.mail.server.example:login:password" \
imixs/exim4
The environment parameter 'EXIM_SMARTHOST' points to the target mail sever used by exim4. The environment parameter 'EXIM_PASSWORD' is written to the exim4/passwd file. This parameter contains the target mail server, user and login data.
To stop and remove the Docker container run the Docker command:
docker stop smarthost && docker rm smarthost
The imixs/exim4 service is supposed to be run as part of a docker service stack. This means that the service is included in a docker-compose.yml file which already contains all the environment variables as shown in the first part of this readme.
The following example shows a service definition of the exim4 service ready to act as smarthost for Office365.
...
smarthost:
image: imixs/exim4:latest
environment:
EXIM_SMARTHOST: "smtp.office365.com:587"
EXIM_PASSWORD: "*.office.com:[email protected]:mypassword"
EXIM_MESSAGE_SIZE_LIMIT: "1M"
EXIM_ALLOWED_SENDERS: "10.1.7.0/24"
....
Please note that for Office365 it must be configured all the Microsoft DNS wildcard.
Exim4 has a default MESSAGE_SIZE_LIMIT of 50M. Exim4 will reject emails with larger size to avoid spam mail. You can set different size here if you provide the environment variable named 'EXIM_MESSAGE_SIZE_LIMIT'.
Example:
-e EXIM_MESSAGE_SIZE_LIMIT=100M
Note: The value must be set as an integer and may not be surrounded in quotes. (100M = 100 MB, where 104857600 is the same value in bytes)
Within your imixs/exim4 docker container you can verify the current setting with the command:
$ exim4 -bP message_size_limit
To follow the exim4 server log:
docker logs -f smarthost
To test your smarthost configuration, first log into the bash of your smarthost:
# log into bash
docker exec -it smarthost /bin/bash
With the following command you can test sending out an email
echo "This is the message" | mail -s "The subject" [email protected] -aFrom:[email protected]
You can link the smarthost Docker container to other containers in your Docker network to allow them to send out mail via the smarthost.
Take care about the default environment setting:
EXIM_ALLOWED_SENDERS=172.17.0.0/24:127.0.0.1
This environment variable defines, if other docker containers running on your docker host, are allowed to use the MTA for sending out e-mails. The default setting is "172.17.0.0/24:127.0.0.1", which allows all linked containers to send mails. Customize this parameter if you have custom needs in your docker virtual network. If the setting is not set correct, you will typically see a log message like
...exim4 IP address .. relay not permitted...
The source is available on Github. Please report any issues.
To build the image from the Dockerfile run:
docker build --tag=imixs/exim4 .
To push the image to a docker repo:
docker build -t imixs/exim4:X.X.X .
docker push imixs/exim4:X.X.X
Content type
Image
Digest
Size
79.7 MB
Last updated
over 6 years ago
docker pull isds/exim-rdm