github-com-docker-mailserver/docker-mailserver
1
0
Fork 0
mirror of https://github.com/docker-mailserver/docker-mailserver.git synced 2024-01-19 02:48:50 +00:00
Code Issues Projects Releases Wiki Activity
docker-mailserver/docs/content/advanced/mail-fetchmail.md

109 lines
3.9 KiB
Markdown
Raw Normal View History

Add link to fetchmail website
2016-08-22 08:20:59 +00:00
To enable the [fetchmail](http://www.fetchmail.info) service to retrieve e-mails set the environment variable `ENABLE_FETCHMAIL` to `1`. Your `docker-compose.yml` file should look like following snippet:
Add documentation proposal for fetchmail service
2016-08-21 12:02:06 +00:00
```
Better docker-compose example
2016-08-21 12:03:37 +00:00
...
environment:
- ENABLE_FETCHMAIL=1
...
Add documentation proposal for fetchmail service
2016-08-21 12:02:06 +00:00
```
Update name
2016-09-04 17:12:17 +00:00
Generate a file called `fetchmail.cf` and place it in the `config` folder. Your `docker-mailserver` folder should look like this example:
Add tree view of folder structure
2016-08-22 08:16:47 +00:00
```
├── config
│   ├── dovecot.cf
│   ├── fetchmail.cf
│   ├── postfix-accounts.cf
│   └── postfix-virtual.cf
├── docker-compose.yml
└── README.md
```
Add configuration examples
2016-08-21 12:10:33 +00:00
Add more headlines
2016-08-22 08:23:51 +00:00
# Configuration
Fix links
2016-08-22 08:41:52 +00:00
A detailed description of the configuration options can be found in the [online version of the manual page](http://www.fetchmail.info/fetchmail-man.html).
Add link to the fetchmail man page
2016-08-22 08:40:34 +00:00
Add configuration examples
2016-08-21 12:10:33 +00:00
## Example IMAP configuration
```
Use quotation marks for hostnames for better separation between key and values. Imap and pop3 can't be written in quotation marks.
2016-08-22 20:42:25 +00:00
poll 'imap.example.com' proto imap
Shorter examples
2016-08-22 20:23:34 +00:00
user 'username'
pass 'secret'
Add configuration examples
2016-08-21 12:10:33 +00:00
is 'user1@domain.tld'
Add ssl to samlpe configuration. SSL is always good
2016-08-29 22:10:48 +00:00
ssl
Add configuration examples
2016-08-21 12:10:33 +00:00
```
## Example POP3 configuration
```
Use quotation marks for hostnames for better separation between key and values. Imap and pop3 can't be written in quotation marks.
2016-08-22 20:42:25 +00:00
poll 'pop3.example.com' proto pop3
Shorter examples
2016-08-22 20:23:34 +00:00
user 'username'
password should be pass
2016-08-22 20:24:07 +00:00
pass 'secret'
Add configuration examples
2016-08-21 12:10:33 +00:00
is 'user2@domain.tld'
Add ssl to samlpe configuration. SSL is always good
2016-08-29 22:10:48 +00:00
ssl
Add configuration examples
2016-08-21 12:10:33 +00:00
```
Add "IMPORTANT" warning
2016-08-22 20:30:47 +00:00
__IMPORTANT__: Don’t forget the last line: e. g. `is 'user1@domain.tld'`. After `is` you have to specify one email address from the configuration file `config/postfix-accounts.cf`.
New Section: Polling interval
2016-08-29 20:13:22 +00:00
More details how to configure fetchmail can be found in the [fetchmail man page in the chapter “The run control file”](http://www.fetchmail.info/fetchmail-man.html#31).
## Polling interval
By default the fetchmail service searches very 5 minutes for new mails on your external mail accounts. You can override this default value by adding this line to your `fetchmail.cf`.
```
set daemon 60
```
You must specify a numeric argument which is a polling interval in seconds. The example above polls every minute for new mails.
Updated Retrieve emails from a remote mail server (using builtin fetchmail) (markdown)
2016-08-22 08:25:14 +00:00
Add more headlines
2016-08-22 08:23:51 +00:00
# Debugging
Add debug commands
2016-08-22 08:12:04 +00:00
To debug your `fetchmail.cf` configuration run this command:
```
Use setup.sh for debugging
2016-08-29 20:04:40 +00:00
./setup.sh debug fetchmail
Add debug commands
2016-08-22 08:12:04 +00:00
```
Add sample debug output
2016-08-29 22:14:21 +00:00
For more informations about the configuration script `setup.sh` [[read the corresponding wiki page|Setup-docker-mailserver-using-the-script-setup.sh]].
Here a sample output of `./setup.sh debug fetchmail`:
```
fetchmail: 6.3.26 querying outlook.office365.com (protocol POP3) at Mon Aug 29 22:11:09 2016: poll started
Trying to connect to 132.245.48.18/995...connected.
fetchmail: Server certificate:
fetchmail: Issuer Organization: Microsoft Corporation
fetchmail: Issuer CommonName: Microsoft IT SSL SHA2
fetchmail: Subject CommonName: outlook.com
fetchmail: Subject Alternative Name: outlook.com
fetchmail: Subject Alternative Name: *.outlook.com
fetchmail: Subject Alternative Name: office365.com
fetchmail: Subject Alternative Name: *.office365.com
fetchmail: Subject Alternative Name: *.live.com
fetchmail: Subject Alternative Name: *.internal.outlook.com
fetchmail: Subject Alternative Name: *.outlook.office365.com
fetchmail: Subject Alternative Name: outlook.office.com
fetchmail: Subject Alternative Name: attachment.outlook.office.net
fetchmail: Subject Alternative Name: attachment.outlook.officeppe.net
fetchmail: Subject Alternative Name: *.office.com
fetchmail: outlook.office365.com key fingerprint: 3A:A4:58:42:56:CD:BD:11:19:5B:CF:1E:85:16:8E:4D
fetchmail: POP3< +OK The Microsoft Exchange POP3 service is ready. [SABFADEAUABSADAAMQBDAEEAMAAwADAANwAuAGUAdQByAHAAcgBkADAAMQAuAHAAcgBvAGQALgBlAHgAYwBoAGEAbgBnAGUAbABhAGIAcwAuAGMAbwBtAA==]
fetchmail: POP3> CAPA
fetchmail: POP3< +OK
fetchmail: POP3< TOP
fetchmail: POP3< UIDL
fetchmail: POP3< SASL PLAIN
fetchmail: POP3< USER
fetchmail: POP3< .
fetchmail: POP3> USER user1@outlook.com
fetchmail: POP3< +OK
fetchmail: POP3> PASS *
fetchmail: POP3< +OK User successfully logged on.
fetchmail: POP3> STAT
fetchmail: POP3< +OK 0 0
fetchmail: No mail for user1@outlook.com at outlook.office365.com
fetchmail: POP3> QUIT
fetchmail: POP3< +OK Microsoft Exchange Server 2016 POP3 server signing off.
fetchmail: 6.3.26 querying outlook.office365.com (protocol POP3) at Mon Aug 29 22:11:11 2016: poll completed
fetchmail: normal termination, status 1
```
Reference in a new issue Copy permalink