From ArchWiki
Jump to: navigation, search

Alpine is based on pine, a text-based E-mail and newsclient that was originally released by the University of Washington in 1991. It is an easier to use alternative to mutt, a more lightweight approach to the mail reader concept.


Install alpineAUR. Optionally a spellchecker may be installed. Alpine supports both aspell and hunspell.


Launch alpine:

$ alpine

Navigate to the config page by pressing S then C. Fill in your name, the name of your mailserver in "User Domain", and your SMTP server for sending mail. The format for the SMTP server is as follows: (or tls)

Also note the format for where Alpine is configured to keep saved and postponed messages. This keeps the messages on the mailserver, instead of saving them locally.


The following example assumes a mailserver located at that uses STARTTLS, a user named Jim Bob, and common locations for mail folders on the server.

Personal Name                     = Jim Bob
User Domain                       =
SMTP Server (for sending)         =
NNTP Server (for news)            = <No Value Set>
Inbox Path                        = {}Inbox
Incoming Archive Folders          = <No Value Set>
Pruned Folders                    = <No Value Set>
Default Fcc (File carbon copy)    = {}Sent
Default Saved Message Folder      = {}Archives
Postponed Folder                  = {}Drafts
Read Message Folder               = <No Value Set>
Form Letter Folder                = <No Value Set>
Trash Folder                      = {}Trash
Literal Signature                 = <No Value Set>
Signature File                    = <No Value Set: using ".signature">
Feature List                      =

Press E to exit config. From the main menu, navigate the collectionLists page by pressing (S then L) to configure folders. Press enter to edit the folders on, and optionall set a nickname. The Server line uses the same fomat as the SMTP Server line above, except that this is for retrieving rather than sending mail. The following example is for an IMAP server:

The Path and View fields can often be left blank.

Setting the return address

To set a return address, enter the config page and navigate to the "Customized Headers" field (either use the "Whereis" command to search, or page down a few pages to find this) and change the value to:

From:  Jim Bob <>

Of course, replace Jim Bob with your name and put your proper e-mail address in the <>.

What else can you configure?

Almost anything, in particular you can specify which colors to use, (from the main menu press S for set up, then K for colors), a browser to open external links (this is in the "Config" setup that we've previously been modifying"), an alternate text editor to use, different folder views, etc.

Pressing W allows you to quickly search for options. Messages can be listed in localtime by enabling the option "Convert Dates to Localtime". Toggling options can be done using the enter key.

Printing from alpine

Printing from Alpine directly to lpr does not work with special characters like Germanic umlauts in the Mail to be printed. The a2ps program does help. You can then edit ~/.pinerc:

# Your default printer selection
printer=YOURPRINTER [] a2ps -q --center-title --footer -PYOURPRINTER

# List of special print commands
personal-print-command=YOURPRINTER [] a2ps -q --center-title --footer -PYOURPRINTER

# Which category default print command is in

Replace YOURPRINTER with the name of your printer. Note that these settings can also be applied in the setup UI of Alpine. See the manpage of a2ps for more configuration options.

Remote Configuration

From the setup page, press Z to enter RemoteConfigSetup. You will be prompted to upload your addressbook, signature, and configuration. In order to use the remote configuration on any computer, on the command line, enter:

$ alpine -p "{}remote_pinerc"

It may be desirable to make this command an alias in your .bashrc.

Tips and Tricks

There is no direct, or immediately apparent command for arbitrarily invoking an update of the inbox, however, as indirectly referenced in the manual;

New mail checking and notification occurs automatically every 2.5 minutes and after certain commands, e.g. refresh-screen (Ctrl-L).

See also

  • - Official Alpine Page. This page includes links to unofficial Alpine pages that have some handy tutorials (arguably better than the one provided here), hit C to open the config menu.