Configuring Mutt for Gandi Mail (IMAP and SMTP)

Gandi is my favorite registrar for many reasons. Their motto is “No Bullshit” and they mean it. They make it super easy to manage domains, and offer tons of great services. One of the best things about buying a domain from Gandi is that they provide you with free email for the life of your domain. Setting up a mail server can be a pain in the ass, so this is really kind of awesome.

mutt is an awesome MUA (Mail User Agent) that is light weight, terminal based, and highly customizable. Your local mail system can be as complex or as simple as you want it to be. There are countless guides out there on how to mutt, but a lot of them seem way to complex for my use case and can get very confusing.

This guide will help you get mutt working with Gandi mail. Gandi mail is a pretty generic mail stack so this should also apply to any other IMAP/SMTP mail system that uses Dovecot, Postfix, etc… as well.

My use case is this:

  1. I use Gandi mail for all of my personal email for a single address.
  2. I want to connect to Gandi using IMAP with mutt
  3. I want to send mail with mutt by connecting to Gandi with SMTP

Note that there are no local folders on my machine in this use case, so everything is happening on the mail server. A lot of the mutt guides assume that you are using mutt for just reading email and are using some external program like fetchmail to receive the mail to a local folder, and some external smtp system like msmtp to send it. This is not what we are doing here, so if you want this type of setup I would suggest looking at this guide instead.

With this simple use case in mind, your .muttrc file becomes super simple.

  1. If you have not already, install mutt.
    #On Debian Based Distros 
    apt-get install mutt 
    #On Red Hat Based Distros 
    yum install mutt 
    #On Mac OS X, assuming you have Homebrew Installed
    brew install mutt 
  2. Open up a text editor and put the following in your ~/.muttrc file
    # Configure imap username and password 
    set imap_user="[email protected]"
    set imap_pass="YourPassword"
    # Configure Default Folder and where to put Sent Mail 
    set folder="imaps://"
    set spoolfile=$folder
    set record="=Sent"
    # Configure SMTP Settings 
    set smtp_url = "smtp://$imap_user:[email protected]:587/"
    set realname="Your Name"
    set from="[email protected]"
    set use_from = yes
    # Enable STARTTLS for Security
    set ssl_starttls=yes
  3. Fire up mutt, you will be logged into your Gandi inbox and you can start rocking out your mail.

This was a super simple config and it “just works”. It allows you to perform the basic functions of receiving, reading, and sending mail. You can now go read about the other 10,000 config options in the mutt manual.


Added STARTTLS to .muttrc example, thanks to Kenn for the catch.

If you made it this far, you should probably follow me on twitter. 🙂

This entry was posted in Hacking. Bookmark the permalink.

2 Responses to Configuring Mutt for Gandi Mail (IMAP and SMTP)

  1. Stig says:

    I’m really struggling with these configs for! It works perfectly with Openmailbox. Is it possible to write a concrete example of the smtp?
    I’ve tried every possible combo now, and still it wont work. Last I tried set smtp_url = “smtp:[email protected]” I think the confusion is that this is hosted by, so I really don’t know which to put in and how. Any suggestions please?

Leave a Reply

Your email address will not be published. Required fields are marked *