Introduction to Mutt

The Mutt package contains a Mail User Agent. This is useful for reading, writing, replying to, saving, and deleting your email.

This package is known to build and work properly using an LFS-7.10 platform.

Package Information

  • Download (FTP):

  • Download MD5 sum: 04ae5b20cee7d746a246968e4a8cb9fa

  • Download size: 3.9 MB

  • Estimated disk space required: 37 MB (plus a further 5MB for the PDF manual)

  • Estimated build time: 0.3 SBU (plus a further 0.1 SBU to build the PDF manual)

Mutt Dependencies


Aspell-, Cyrus SASL-2.1.26, GDB-7.12, GnuPG-2.1.15, GPGME-1.7.1, libgssapi, libidn-1.33, MIT Kerberos V5-1.14.4, Mixmaster, an MTA (that provides a sendmail command), S-Lang-2.2.4, OpenSSL-1.0.2j or GnuTLS-3.5.5, Berkeley DB-6.2.23 or QDBM or Tokyo Cabinet

Optional (To Regenerate HTML Documentation)

libxslt-1.1.29 and either Lynx-2.8.8rel.2, w3m-0.5.3, or ELinks

Optional (To Generate PDF Manual)

docbook-dsssl-1.79, OpenJade-1.3.2, and texlive-20160523b (or install-tl-unx)

User Notes:

Installation of Mutt

Mutt requires a group named mail. You can add this group, if it does not exist, with this command:

groupadd -g 34 mail

If you did not install an MTA, you need to modify the ownership of /var/mail with this command:

chgrp -v mail /var/mail

Mutt will rebuild the html documentation if libxslt is present, then use that to update the text manual - even if none of the specified browsers are present. That will create an empty text file, so we will save the shipped file.

Install Mutt by running the following commands:

cp -v doc/manual.txt{,.shipped} &&
./configure --prefix=/usr                           \
            --sysconfdir=/etc                       \
            --with-docdir=/usr/share/doc/mutt-1.7.1 \
            --enable-external-dotlock               \
            --enable-pop                            \
            --enable-imap                           \
            --enable-hcache                         \
            --enable-sidebar                        &&
make &&
test -s doc/manual.txt || mv -v doc/manual.txt{.shipped,}

To generate the PDF manual with texlive-20160523b, run the following command:

make -C doc manual.pdf

This package does not come with a test suite.

Now, as the root user:

make install

If you generated the PDF manual, install it by issuing the following command as the root user:

install -v -m644 doc/manual.pdf \


If you used a DESTDIR method to only install to a temporary location as a regular user (as part of a package menagement process), you will need to run the following as the root user after completing the real install:

chown root:mail /usr/bin/mutt_dotlock &&
chmod -v 2755 /usr/bin/mutt_dotclock

Command Explanations

--enable-external-dotlock: In some circumstances the mutt-dotlock program is not created. This switch ensures it is always created.

--enable-pop: This switch enables POP3 support.

--enable-imap: This switch enables IMAP support.

--enable-hcache: This switch enables header caching.

--enable-sidebar: This switch enables support for the sidebar (a list of mailboxes). It is off by default, but can be turned on by :set sidebar_visible in mutt (and off again with ':unset'), or it can be enabled in ~/.muttrc.

--enable-smtp: This switch enables SMTP relay support.

--with-ssl: This parameter adds SSL/TLS support from OpenSSL-1.0.2j in POP3/IMAP/SMTP if they are enabled.

--with-sasl: This parameter adds authentication support from Cyrus SASL-2.1.26 in POP3/IMAP/SMTP if they are enabled. Depending on the server configuration, this may not be needed for POP3 or IMAP. However, it is needed for SMTP authentication.

test -s doc/manual.txt || mv -v doc/manual.txt{.shipped,}: if the text manual is now empty (libxslt is installed, but without any of the specified text browsers), restore it from the copy.

Configuring Mutt

Config Files

/etc/Muttrc, ~/.muttrc, /etc/mime.types, ~/.mime.types

Configuration Information

No changes in these files are necessary to begin using Mutt. When you are ready to make changes, the man page for muttrc is a good starting place.

In order to utilize GnuPG, use the following command:

cat /usr/share/doc/mutt-1.7.1/samples/gpg.rc >> ~/.muttrc


Installed Programs: flea, mutt, mutt_dotlock, muttbug, pgpewrap, pgpring, and smime_keys
Installed Libraries: None
Installed Directories: /usr/share/doc/mutt-1.7.1

Short Descriptions


is a bug submitter for Mutt.


is a Mail User Agent (MUA) which enables you to read, write and delete your email.


implements the mail spool file lock.


is a script that executes flea.


prepares a command line for the GnuPG-2.1.15 utilities.


is a key ring dumper for PGP. It is not needed for GnuPG-2.1.15.


manages a keystore for S/MIME certificates.

Last updated on 2016-10-12 08:54:06 -0500