Building & Installing Geary 0.4

These instructions are for building Geary 0.4.x. See the INSTALL file if you're building from git.


Fetch and extract the latest tarball from

To build, from the extracted folder run:

$ ./configure
$ make

Building Geary requires Vala 0.20.1 or higher with a full GIR repository, intltool, cmake, and desktop-file-validate.

The developer packages (headers) for the following libraries are also required when building any version of Geary:

  • canberra
  • gee-0.8
  • gio-2.0
  • glib-2.0
  • gmime-2.6
  • gtk+-3.0
  • libsecret-1
  • libxml-2.0
  • notify
  • sqlite3
  • unique-3.0
  • webkitgtk-3.0
  • messaging-menu (optional; enables support for Ubuntu Unity messaging menu)

  • unity (optional; enables support for Ubuntu Unity launcher)

Most of these are standard libraries available from major distros' repositories.

Geary requires WebKitGTK-3 1.10 or higher. However, it will not build with WebKitGTK-3 versions 2.1.1 to See this ticket for more details.


On Fedora 18, you can install build dependencies for Geary as follows:

$ sudo yum install vala gobject-introspection-devel intltool cmake \
    desktop-file-utils libcanberra-devel libgee-devel glib2-devel gmime-devel \
    gtk3-devel libnotify-devel sqlite-devel unique3-devel webkitgtk3-devel \
    libsecret-devel libxml2-devel


In Ubuntu versions prior to 13.10, you can install Vala 0.20 from the Vala PPA, which you can add to your system as follows:

$ sudo add-apt-repository ppa:vala-team/ppa
$ sudo apt-get update
$ sudo apt-get upgrade

Ubuntu 13.10 already ships with the correct version of Vala.

In either case, you can obtain the dependencies for Geary with this command:

$ sudo apt-get install valac-0.20 libgirepository1.0-dev intltool cmake \
    desktop-file-utils libcanberra-dev libgee-0.8-dev libglib2.0-dev \
    libgmime-2.6-dev libgtk-3-dev libsecret-1-dev libxml2-dev libnotify-dev \
    libsqlite3-dev libunique-3.0-dev libwebkitgtk-3.0-dev libmessaging-menu-dev \

Note that Ubuntu 12.04 does not have all the dependencies to build Geary from git; here are some hints on getting everything installed.

You should check that you are using the right version of valac with the command valac --version:

Vala 0.20.1

The version number must be at least 0.20.1. If it reports an earlier version, run

$ sudo update-alternatives --config valac

and select 0.20 there.


Once compiled, Geary can be run straight from the build directory:

$ ./geary

It will prompt for a username and a password. Geary will then fetch all the account folders and load the most recent messages from the Inbox.


After building, Geary can be installed with:

$ sudo make install

and removed with:

$ sudo make uninstall

Apps/Geary/BuildingInstalling (last edited 2014-01-07 21:44:08 by CharlesLindsay)