This page walks through a simple installation and configuration of getmail.

It uses the Debian package manager, apt, as an example but the process should translate to any Linux variant.

Last checked/updated: May 2023.

(a) install getmail and create mail directories.

$ sudo apt install getmail6
$ mkdir ~/.getmail
$ mkdir ~/mail
$ mkdir ~/mail/cur
$ mkdir ~/mail/new
$ mkdir ~/mail/tmp

(b) create getmail configuration file ~/.getmail/getmailrc (a plain text file). You will need to fill in your email provider's information, including your username (username@gmail.com) and password, so the program can fetch your emails. You also choose which folders to fetch, for instance just the inbox or also sent mail.

Example contents of ~/.getmail/getmailrc (fill in server if not gmail, mailboxes, USERNAME, and PASSWORD):

[retriever]
type = SimpleIMAPSSLRetriever
server = imap.gmail.com
mailboxes = ("[Gmail]/All Mail", )
username = USER
password = PASS

[destination]
type = Maildir
path = ~/mail/

[options]
[options]
# only download *new* emails
read_all = false

# do not alter status of emails on server
delivered_to = false

# ditto
received = false

# do not delete emails on server
delete = false

# max downloaded each time; use 0 for no limit
max_messages_per_session = 0

message_log = ~/.getmail/log

(c) after creating the file, run $ chmod -R 700 ~/.getmail in order to prevent other users of the computer from reading this file. (But be aware of the privacy ramifications of storing your email password on your computer in plain text.

Done! Now, running getmail from the command line will connect to the server and download any new emails into ~/mail/tmp/. (Running it for the first time may take hours...)


(d) (bonus) you can use cron to have your linux system automatically run getmail every so often.

$ sudo apt install cron

For example, to connect every 10 minutes, simply run

$ crontab -e

to open the the crontab file for editing, and insert the line

*/10 * * * * getmail

which tells cron to run getmail once every 10 minutes of every hour of every day of every month of every year.