Configuring Mutt for Gandi Mail (IMAP and SMTP)

| tui | foss | linux |

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://mail.gandi.net:993/”

    set spoolfile=$folder set record="=Sent"

    Configure SMTP Settings

    set smtp_url = “smtp://$imap_user:$imap_[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.

UPDATE 1:

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

Thank you for reading! Share your thoughts with me on bluesky, mastodon, or via email.

Check out some more stuff to read down below.

Most popular posts this month

Recent Favorite Blog Posts

This is a collection of the last 8 posts that I bookmarked.

Articles from blogs I follow around the net

Understanding ChatGPT Work

OpenAI announced ChatGPT Work on July 9th, and have been furiously iterating on it ever since. It is an extraordinarily confusing and very powerful product. Here's what I've figured out about it so far. ChatGPT Work is actually two products The more intere...

via Simon Willison's Weblog: Entries August 30, 2026

“I just chose words carefully.”

I don’t think anyone particularly enjoys typesetting in monospace. Regular text is okay – at least as okay as it can be: Right aligning is also fine, as long as you don’t mind counting spaces, but centering already gets tricky, as you don’t have a half spa...

via Unsung August 30, 2026

Weeknote #2016

St Jude, GTA, and lots of other links.

via Robb Knight • Posts • Atom Feed August 30, 2026

Generated by openring