Retrieving Emails From Remote Servers With fetchmail on Debian

Fetchmail is a program for retrieving emails from remote servers. Imagine you have five email accounts on five different servers. Of course, you don't want to connect to each of them to get your emails. This is where fetchmail comes into play. If you have a user account on a Linux server, you can make fetchmail download emails from remote servers and put them into just one mailbox (the one of your Linux user), from where you can retrieve them with your email client (e.g. Thunderbird or Outlook).

Or imagine you have an email account at a provider that doesn't do spam- and virus filtering. In that case you could use fetchmail to download the mails to your own server and pipe them through spam- and virus filters (e.g. SpamAssassin and ClamAV) before you download the mails with your email client.

1 Preliminary Note

You need a Linux server with a system user that can receive emails, which means an MTA such as Postfix or Sendmail must be installed on the system. Otherwise, fetchmail won't work, because it tries to pass on the downloaded emails to an MTA (Postfix, Sendmail, ...), and the MTA delivers the mails to the user's mailbox (you can configure the system to include spam- and virus scanning in this process, e.g. with amavisd-new or procmail, but this isn't covered in this tutorial).

I use a Debian system in this tutorial where two users called falko and till exist.

2 Install fetchmail

In order to install fetchmail, all we have to do is run

apt install fetchmail

3 Configure fetchmail

There are two ways of configuring fetchmail. We can make it run as a daemon with a global configuration file, or we can create a cron job to run fetchmail together with per-user configuration files. I will describe both methods here.

3.1 Run fetchmail As A Daemon With A Global Configuration File

To make fetchmail run as a daemon, we have to edit /etc/default/fetchmail and set START_DAEMON to yes:

nano /etc/default/fetchmail
# This file will be used to declare some vars for fetchmail
# Uncomment the following if you dont want localized log messages
# export LC_ALL=C

# Declare here if we want to start fetchmail. 'yes' or 'no'

Next we must create the configuration file /etc/fetchmailrc because the fetchmail daemon won't start if this file doesn't exist. In this file we can specify how the fetchmail daemon should behave as well as the details fetchmail needs to know to retrieve emails from foreign email accounts.

Let's assume falko has two email accounts from which we want to retrieve emails:

  • First account: server pop.someprovider.tld, protocol POP3, username [email protected] (yes, the username is an email address in this case), password secret.
  • Second account: server mail.otherprovider.tld, protocol POP3, username ftimme, password verysecurepassword.

till has one email account:

  • Server mailin.tillsprovider.tld, protocol POP3, username tbrehm, password iwonttellyou.

So our file /etc/fetchmailrc could look like this:

nano /etc/fetchmailrc
# /etc/fetchmailrc for system-wide daemon mode
# This file must be chmod 0600, owner fetchmail

set daemon        300                # Pool every 5 minutes
set syslog                        # log through syslog facility
set postmaster  root

set no bouncemail                # avoid loss on 4xx errors
                                # on the other hand, 5xx errors get
                                # more dangerous...

# Hosts to pool

# Defaults ===============================================================
# Set antispam to -1, since it is far safer to use that together with
# no bouncemail
timeout 300
antispam -1
batchlimit 100

poll pop.someprovider.tld protocol POP3 user "[email protected]" there with password "secret" is falko here
poll mail.otherprovider.tld protocol POP3 user "ftimme" there with password "verysecurepassword" is falko here fetchall
poll mailin.tillsprovider.tld protocol POP3 user "tbrehm" there with password "iwonttellyou" is till here keep

At the beginning of the file we have some global options such as set daemon 300 (which means fetchmail should retrieve emails every 300 seconds) that control the operation of the program. The meanings of the above options are as follows:

  • set daemon: Set a background poll interval in seconds.
  • set syslog: Do error logging through syslog.
  • set postmaster: Give the name of the last-resort mail recipient (default: user running fetchmail, "postmaster" if run by the root user).
  • set no bouncemail: Direct error mail to the local postmaster (as per the "postmaster" global option above).

Then we have the server and the user options options. These go together into the lines beginning with poll; if there are options that are the same for each poll line, we can as well specify them before the poll lines in a section that begins with defaults: (such as timeout, antispam, and batchlimit in our example).

  • timeout: Server inactivity timeout in seconds (default 300).
  • antispam: Specify what SMTP returns are interpreted as spam-policy blocks.
  • batchlimit: Specify the maximum number of messages that will be shipped to an SMTP listener before the connection is deliberately torn down and rebuilt (defaults to 0, meaning no limit).

The poll lines are self-explanatory; as you see fetchmail retrieves emails from both of falko's external email accounts and puts them into one account.

You will notice that the poll lines have different endings (e.g. nofetchall (default), fetchall, keep, nokeep). The meanings are as follows:

  • nofetchall: Retrieve only new messages (default). If nothing else is specified (e.g. fetchall, keep), this means nofetchall.
  • fetchall: Fetch all messages whether seen or not.
  • keep: Don't delete seen messages from server.
  • nokeep: Delete seen messages from server.

To learn more about all available configuration settings, take a look at

man fetchmail

/etc/fetchmailrc must have 600 permissions and must be owned by the user fetchmail, so we do the following:

chmod 600 /etc/fetchmailrc
chown fetchmail /etc/fetchmailrc

Finally, we can start fetchmail:

/etc/init.d/fetchmail start

Fetchmail should now download emails and put them into falko's and till's mailboxes (using the MTA). It will repeat this every set daemon seconds.

3.2 Use Per-User Configuration Files And Run fetchmail Via Cron

Instead of using a global configuration file as shown in chapter 3.1, we can use per-user configuration files. These must have the name .fetchmailrc and must be located in the user's homedir.

We want to create such a file for the user falko now. Make sure you're logged in as falko, not root! Then we do this:

cd ~/
vi .fetchmailrc
set postmaster falko
set bouncemail

poll pop.someprovider.tld protocol POP3 user "[email protected]" there with password "secret"
poll mail.otherprovider.tld protocol POP3 user "ftimme" there with password "verysecurepassword" fetchall

The file looks very similar to the file /etc/fetchmailrc from chapter 3.1, however you will notice that I don't use the phrase is falko here anymore (as .fetchmailrc is in falko's homedir, fetchmail knows that the mails should be delivered to falko). Of course, you can still use is falko here, so the file could look like this as well:

set postmaster falko
set bouncemail

poll pop.someprovider.tld protocol POP3 user "[email protected]" there with password "secret" is falko here
poll mail.otherprovider.tld protocol POP3 user "ftimme" there with password "verysecurepassword" is falko here fetchall

To learn more about all available configuration settings, take a look at

man fetchmail

.fetchmailrc must have 600 permissions, so that only falko can read from/write to it:

chmod 600 ~/.fetchmailrc

That's it. Now falko can start the retrieval process by running



fetchmail -v

which shows what's going on.

Of course, falko doesn't want to start the retrieval manually every few minutes, so we create a cron job for him. Still as the user falko, we run

crontab -e

and create a cron job like this one (which would start fetchmail every five minutes):

*/5 * * * * /usr/bin/fetchmail &> /dev/null
Share this page:

Suggested articles

9 Comment(s)

Add comment


By: at: 2007-05-30 22:03:32


Thanks for Falko for this great howto! Here is another good one related to fetchmail:

This is about how to configure fetchmail to use with mailboxes having SSL, especially with gmail. Of course the principles of it can be applied to any SSL capable mailbox as well.



By: at: 2007-05-31 14:19:31

Hey, Falko.

You are reading in my mind... I was working on that subject ('cause i need it) ;)

Of course, i'll stop mine to follow your HowTo.


Thanks a lot


Keep up the great work! 

By: at: 2007-06-01 22:31:45

It's been a long time since I set up my fetchmail (it's one of those "set and forget" things) but, IIRC, an existing, properly configured MTA is not a prerequisite, as the preliminary comment states.

 Fetchmail should hand off retrieved mail to whatever application is stipulated in the run control file. It defaults to port 25 only if it has not been given another application.

 Fetchmail can also be forced to deliver directly to the user's mail spool:

and wants mda "/usr/bin/procmail -d user"


Robert Thorsby

By: Harvey at: 2011-09-04 13:27:50

Like someone else, it's been years since I last set up fetchmail, so thanks for making it as painless as possible - I couldn't remember how to do it at all!

By: Jonathan at: 2015-05-12 09:56:25

Worked perfectly even in 2015, thanks a bunch!

By: karanik at: 2015-05-18 08:19:56

Is there a way to perform fetching for 50 different zimbra users, when each user has his own pop accounts?

By: ass at: 2015-06-02 12:49:04

# Configure the ISP accounts (POP server, users and respective passwords) poll with protocol POP3: user "johndoe", password "pass1", is john here; user "janedoe", password "pass2", is jane here

By: kenneth558 at: 2015-11-01 03:34:23

Robert, you say "Fetchmail should hand off retrieved mail to whatever application is stipulated in the run control file."  An example would sure help me a lot since all I'm going to do is send emails to my server for it to launch scripts.  I don't have any email viewer on it, I don't plan on reading emails at that console.

By: Chandran Manikandan at: 2017-07-21 10:00:44

Hi Friend,

I would like to take a backup of all email accounts and emails from the live server. I have run qmailtoaster in centos server in live server.

Could you help me, how to setup and configure fetchmail server in another machine.

I want to keep all the email account and emails in both the server.

Thank you,