IMAP. It can even forward email messages to an
SMTPserver, if necessary.
yum install fetchmail
.fetchmailrcfile in the user's home directory. If it does not already exist, create the
.fetchmailrcfile in your home directory
.fetchmailrcfile, Fetchmail checks for email on a remote server and downloads it. It then delivers it to port
25on the local machine, using the local MTA to place the email in the correct user's spool file. If Procmail is available, it is launched to filter the email and place it in a mailbox so that it can be read by an MUA.
220.127.116.11. Fetchmail Configuration Options
.fetchmailrcfile is much easier. Place any desired configuration options in the
.fetchmailrcfile for those options to be used each time the
fetchmailcommand is issued. It is possible to override these at the time Fetchmail is run by specifying that option on the command line.
.fetchmailrcfile contains three classes of configuration options:
- global options — Gives Fetchmail instructions that control the operation of the program or provide settings for every connection that checks for email.
- server options — Specifies necessary information about the server being polled, such as the host name, as well as preferences for specific email servers, such as the port to check or number of seconds to wait before timing out. These options affect every user using that server.
- user options — Contains information, such as user name and password, necessary to authenticate and check for email using a specified email server.
.fetchmailrcfile, followed by one or more server options, each of which designate a different email server that Fetchmail should check. User options follow server options for each user account checking that email server. Like server options, multiple user options may be specified for use with a particular server as well as to check multiple email accounts on the same server.
.fetchmailrcfile by the use of a special option verb,
skip, that precedes any of the server information. The
pollaction tells Fetchmail to use this server option when it is run, which checks for email using the specified user options. Any server options after a
skipaction, however, are not checked unless this server's host name is specified when Fetchmail is invoked. The
skipoption is useful when testing configurations in the
.fetchmailrcfile because it only checks skipped servers when specifically invoked, and does not affect any currently working configurations.
set postmaster "user1" set bouncemail poll pop.domain.com proto pop3 user 'user1' there with password 'secret' is user1 here poll mail.domain2.com user 'user5' there with password 'secret2' is user1 here user 'user7' there with password 'secret3' is user1 here
postmasteroption) and all email errors are sent to the postmaster instead of the sender (
setaction tells Fetchmail that this line contains a global option. Then, two email servers are specified, one set to check using
POP3, the other for trying various protocols to find one that works. Two users are checked using the second server option, but all email found for any user is sent to
user1's mail spool. This allows multiple mailboxes to be checked on multiple servers, while appearing in a single MUA inbox. Each user's specific information begins with the
.fetchmailrcfile. Omitting the
with password '<password>'section causes Fetchmail to ask for a password when it is launched.
fetchmailman page explains each option in detail, but the most common ones are listed in the following three sections.
18.104.22.168. Global Options
daemon seconds— Specifies daemon-mode, where Fetchmail stays in the background. Replace seconds with the number of seconds Fetchmail is to wait before polling the server.
postmaster— Specifies a local user to send mail to in case of delivery problems.
syslog— Specifies the log file for errors and status messages. By default, this is
22.214.171.124. Server Options
auth auth-type— Replace auth-type with the type of authentication to be used. By default,
passwordauthentication is used, but some protocols support other types of authentication, including
ssh. If the
anyauthentication type is used, Fetchmail first tries methods that do not require a password, then methods that mask the password, and finally attempts to send the password unencrypted to authenticate to the server.
interval number— Polls the specified server every
numberof times that it checks for email on all configured servers. This option is generally used for email servers where the user rarely receives messages.
port port-number— Replace port-number with the port number. This value overrides the default port number for the specified protocol.
proto protocol— Replace protocol with the protocol, such as
imap, to use when checking for messages on the server.
timeout seconds— Replace seconds with the number of seconds of server inactivity after which Fetchmail gives up on a connection attempt. If this value is not set, a default of
300seconds is used.
126.96.36.199. User Options
useroption (defined below).
fetchall— Orders Fetchmail to download all messages in the queue, including messages that have already been viewed. By default, Fetchmail only pulls down new messages.
fetchlimit number— Replace number with the number of messages to be retrieved before stopping.
flush— Deletes all previously viewed messages in the queue before retrieving new messages.
limit max-number-bytes— Replace max-number-bytes with the maximum size in bytes that messages are allowed to be when retrieved by Fetchmail. This option is useful with slow network links, when a large message takes too long to download.
password 'password'— Replace password with the user's password.
preconnect "command"— Replace command with a command to be executed before retrieving messages for the user.
postconnect "command"— Replace command with a command to be executed after retrieving messages for the user.
ssl— Activates SSL encryption. At the time of writing, the default action is to use the best available from
TLS1.2. Note that
SSL2is considered obsolete and due to the POODLE: SSLv3 vulnerability (CVE-2014-3566),
SSLv3should not be used. However there is no way to force the use of TLS1 or newer, therefore ensure the mail server being connected to is configured not to use
stunnelwhere the server cannot be configured not to use
sslproto— Defines allowed SSL or TLS protocols. Possible values are
TLS1. The default value, if
sslprotois omitted, unset, or set to an invalid value, is
SSL23. The default action is to use the best from
TLS1.2. Note that setting any other value for SSL or TLS will disable all the other protocols. Due to the POODLE: SSLv3 vulnerability (CVE-2014-3566), it is recommend to omit this option, or set it to
SSLv23, and configure the corresponding mail server not to use
stunnelwhere the server cannot be configured not to use
user "username"— Replace username with the username used by Fetchmail to retrieve messages. This option must precede all other user options.
188.8.131.52. Fetchmail Command Options
fetchmailcommand mirror the
.fetchmailrcconfiguration options. In this way, Fetchmail may be used with or without a configuration file. These options are not used on the command line by most users because it is easier to leave them in the
fetchmailcommand with other options for a particular purpose. It is possible to issue command options to temporarily override a
.fetchmailrcsetting that is causing an error, as any options specified at the command line override configuration file options.
184.108.40.206. Informational or Debugging Options
fetchmailcommand can supply important information.
--configdump— Displays every possible option based on information from
.fetchmailrcand Fetchmail defaults. No email is retrieved for any users when using this option.
-s— Executes Fetchmail in silent mode, preventing any messages, other than errors, from appearing after the
-v— Executes Fetchmail in verbose mode, displaying every communication between Fetchmail and remote email servers.
-V— Displays detailed version information, lists its global options, and shows settings to be used with each user, including the email protocol and authentication method. No email is retrieved for any users when using this option.
220.127.116.11. Special Options
-a— Fetchmail downloads all messages from the remote email server, whether new or previously viewed. By default, Fetchmail only downloads new messages.
-k— Fetchmail leaves the messages on the remote email server after downloading them. This option overrides the default behavior of deleting messages after downloading them.
-l max-number-bytes— Fetchmail does not download any messages over a particular size and leaves them on the remote email server.
--quit— Quits the Fetchmail daemon process.
.fetchmailrcoptions can be found in the