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-8.0 platform.

Package Information

  • Download (FTP):

  • Download MD5 sum: 15425c4c9946d58c22ccb44901544e6d

  • 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.1, GnuPG-2.1.18, GPGME-1.8.0, libgssapi, libidn-1.33, MIT Kerberos V5-1.15, Mixmaster, an MTA (that provides a sendmail command), slang-2.3.1, OpenSSL-1.0.2k or GnuTLS-3.5.9, 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.2 \
            --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.2k 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.2/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.2

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.18 utilities.


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


manages a keystore for S/MIME certificates.

Last updated on 2017-02-22 16:21:14 -0800