Introduction to Balsa

The Balsa package contains a GNOME-2 based mail client.

Package Information

Balsa Dependencies


libgnomeui-2.18.1, ScrollKeeper-0.3.14, GMime-2.2.10, and Aspell-0.60.5 or GtkSpell (GtkSpell provides on-the-fly as you type spell checking)



GtkHTML-3.14.3, gtksourceview-1.8.5, OpenSSL-0.9.8g, OpenLDAP-2.3.39, Compface-1.5.2, Heimdal-1.1 or MIT Kerberos V5-1.6, libnotify, SQLite, and an MTA (that provides a sendmail command, note that it is only used if you didn't install the recommended libESMTP package)

Optional to Build S/MIME Support

GPGME (requires GnuPG-2.0.8)

User Notes:

Installation of Balsa

Install Balsa by running the following commands:

./configure --prefix=$(pkg-config --variable=prefix ORBit-2.0) \
            --sysconfdir=/etc/gnome/2.18.3 \
            --localstatedir=/var/lib \
            --with-rubrica \
            --with-gtkhtml=no &&

This package does not come with a test suite.

Now, as the root user:

make install

Command Explanations

--prefix=$(pkg-config --variable=prefix ORBit-2.0): Setting the prefix using this parameter instead of with $GNOME_PREFIX will ensure that the prefix is consistent with the installation environment and the package will be installed in the correct location.

--sysconfdir=/etc/gnome/2.18.3: This parameter causes the configuration files to be installed in /etc/gnome/2.18.3 instead of $GNOME_PREFIX/etc. Additionally (if applicable), the parameter ensures that the GConf-2 database is correctly updated.

--localstatedir=/var/lib: This parameter is used so that all ScrollKeeper files are installed in, and the ScrollKeeper database is properly updated in /var/lib/scrollkeeper instead of some files being installed in $GNOME_PREFIX/var/scrollkeeper.

--with-rubrica: This parameter is used to provide Rubrica2 address book support.

--with-gtkhtml=no: This parameter is used if you don't have libgtkhtml installed. Remove this parameter if the package is installed. Note that you won't be able to read or write HTML formatted mail messages if you use this parameter.

--with-esmtp=no: Use this parameter if you don't have libESMTP installed.

--with-ssl: Use this option to enable SSL support if OpenSSL is installed.

--with-ldap: Use this option to enable LDAP address book support if OpenLDAP is installed.

--with-sqlite: Use this option to enable SQLite address book support if SQLite is installed.

--with-gpgme: Use this option to enable GPG support if “GnuPG Made Easy” (GPGME) is installed.

--enable-smime: Use this option to enable S/MIME support if GnuPG-2.x.x is installed.

Configuring Balsa

Configuration Information

All configuration of Balsa is done through the Balsa menu system, with mailbox configuration done with the Settings—>Preferences menu.

If you are unable to connect to your ISP, they probably don't support APOP. Disable it in Settings/Preferences/POP3/advanced.

If you enable filters for your incoming POP3 mail, you must have Procmail-3.22 installed, as the incoming mail will be handed off to procmail for processing.


Installed Programs: balsa and balsa-ab
Installed Libraries: None
Installed Directories: The following subdirectories of $GNOME_PREFIX/share/: {gnome/help, omf, sounds}/balsa

Short Descriptions


is a GNOME-2 based mail client.

Last updated on 2008-03-07 16:50:38 -0600