Travel off the grid and still send emails with putmail

Configure your mail client to automatically send emails next time you have an internet connection.
2 readers like this.
Chat via email

Automation is a hot topic right now. In my day job as an SRE part of my remit is to automate as many repeating tasks as possible. But how many of us do that in our daily, not-work, lives? This year, I am focused on automating away the toil so that we can focus on the things that are important.

In "normal times" my wife and I travel a lot. And as anyone who similarly travels a lot knows, connectivity can be very expensive. We were recently on a cruise and the "Premium" ship-board internet cost upwards of $200 for the full 7 days, and even then it had all the drawbacks of satellite internet in terms of speed and congestion. So to make my life easier, I set up offlineimap to download my mail, dovecot to let me use an IMAP client to read my mail, and msmtp to send mail from my various accounts. I covered much of this setup in 2020, and the rest is documented in many places online.

What is not often discussed is that you still need to be online to send mail. The most common recommended solution for sending mail is msmtp, and it always rejects mail if it can't connect to the desired host. But it does have a daemon option (msmtpd) that can be used to accept local SMTP connections and forward them to another program. By default, this is msmtp itself. But again, I don't want to send things now, I want to send things when I have a connection, which is when I stumbled upon putmail.

Putmail is a set of Python scripts that sends mail to pre-configured smtp servers based on the From address in a mail message. It is stable (unmodified since 2011), and just works. If you, like me, have multiple email addresses which have to be sent via multiple SMTP relays, this is just the thing you need. Each email address you send from has its own configuration file, and since putmail decides on which to use based on the message itself, there's no need to have to set up multiple sending setups in a single mail client.

As an example, to send with a gmail account, you would create the file .putmail/ and fill in the following information. putmail configuration
email =
server =
port = 587
username =
tls = on

And that's it. Configure a mail client to send via instead of sendmail or msmtp and send a message.

The next best things are the and scripts. The first takes an email and stores it to send later. The second loops through the queue and delivers the mail. By specifying as the program msmtpd runs, I can "send" an email now, and it just waits for me to run later. Here is my msmtpd startup command, specifying as the item to be used for mail delivery.

msmtpd --port=1025 --log=/tmp/msmtpd.log --command=' -f %F' -

I use the following script as a presynchook in offlineimap to check to see if I am connected, and if so, send mail.

echo Sending queued messages \(if any\)
QUEUEDMAIL=$(find $HOME/.putmail/queue -type f | wc -l)
if [ $QUEUEDMAIL -ne 0 ]; then
  ping -n -c 1 >/dev/null 2>/dev/null
  if [ $? -eq 0 ]; then

After all that, I can use any mail client I wish and send mail with a standard SMTP call to localhost:1025 and have it delivered next time I'm connected to the internet. And the best part is, I don't have to change my workflow for email if I'm home or traveling — it all just happens automatically in the background.

What to read next
User profile image.
Kevin Sonney is a technology professional, media producer, and podcaster. A Linux Sysadmin and Open Source advocate, Kevin has over 25 years in the IT industry, with over 15 years in Open Source. He currently works as an SRE at elastic.

Comments are closed.

Creative Commons LicenseThis work is licensed under a Creative Commons Attribution-Share Alike 4.0 International License.