docker-mailserver/docs/content/advanced/mail-fetchmail.md

To enable the fetchmail service to retrieve e-mails set the environment variable ENABLE_FETCHMAIL to 1. Your docker-compose.yml file should look like following snippet:

...
environment:
  - ENABLE_FETCHMAIL=1
...

Generate a file called fetchmail.cf and place it in the config folder. Your dockermail folder should look like this example:

├── config
│   ├── dovecot.cf
│   ├── fetchmail.cf
│   ├── postfix-accounts.cf
│   └── postfix-virtual.cf
├── docker-compose.yml
└── README.md

Configuration

A detailed description of the configuration options can be found in the online version of the manual page.

Example IMAP configuration

poll imap.example.com proto imap
	user 'username'
	pass 'secret'
	is 'user1@domain.tld'

Example POP3 configuration

poll pop3.example.com proto pop3
	user 'username'
	password 'secret'
	is 'user2@domain.tld'

More details how to configure fetchmail can be found in the fetchmail man page in the chapter “The run control file”.

Debugging

To debug your fetchmail.cf configuration run this command:

docker run --rm \
  -v "$(pwd)/config:/tmp/docker-mailserver" \
  -ti tvial/docker-mailserver:latest \
  sh -c "cat /etc/fetchmailrc_general /tmp/docker-mailserver/fetchmail.cf > /etc/fetchmailrc; /etc/init.d/fetchmail debug-run"

By default the fetchmail service searches very 5 minutes for new mails on your external mail accounts.