en | Installation | Linux

Procedures to install and set up KeeFox on Linux.

Debian, Ubuntu, Mint

Install KeePass 2

KeePass 2 is available as the keepass2 package. KeeFox requires version 2.34 or higher.

For Ubuntu Precise, Trusty and Xenial, the packaged version is too old, so you must first add the KeePass 2 PPA. Add ppa:jtaylor/keepass to the software sources, either through the GUI or by running

sudo add-apt-repository ppa:jtaylor/keepass

In Ubuntu Yakkety or later, and Debian Wheezy or later, simply install the package from the repositories:

sudo apt-get install keepass2

You probably also need to install the Mono compilers:

sudo apt-get install mono-complete

Install the Firefox extension

You can use the PPA kindly provided by David Lechner, or you can install it manually.

Install KeeFox and KeePassRPC using the PPA

UPDATE: Thanks to Mozilla's addon signing, the Firefox addon package (xul-ext-keefox) won't work with Firefox >= 43.

0. Open a terminal window

1. Type the following commands:

    sudo apt-add-repository ppa:dlech/keepass2-plugins
    sudo apt-get update && sudo apt-get install xul-ext-keefox
   

Install KeeFox manually

Install the KeeFox Firefox extension the usual way (using the link provided).

Install the KeePassRPC plugin

To communicate with KeePass, KeeFox uses the KeePassRPC plugin.

If you used the PPA, KeePassRPC will be installed automatically as a dependency of the xul-ext-keefox package. You don't need to do anything here.

Install KeePassRPC manually

The Firefox extension saves the KeePassRPC plugin to your Firefox profile directory, but you will need to install it manually:

0. Create the KeePass plugins directory: sudo mkdir /usr/lib/keepass2/plugins

1. Locate the KeePassRPC.plgx file in your Firefox profile directory (by default ~/.mozilla/firefox/[randomstring].default/), under /extensions/keefox@chris.tomlinson/deps/. Chdir to this directory, and install it using

     sudo cp 'KeePassRPC.plgx' '/usr/lib/keepass2/plugins/'
   

Install additional plugin dependencies (Ubuntu 16.04 only)

On Ubuntu 16.04, you will also need to install two additional dependencies with:

    sudo apt-get install libmono-system-configuration-install4.0-cil libmono-system-management4.0-cil

If you get a popup saying

The following plugin is incompatible with the current KeePass version: /usr/lib/keepass2/plugins/KeePassRPC.plgx Have a look at the plugin's website for an appropriate version.

and clearing the plugin cache did not solve the problem, according to #657, you may also need to install another 4 additional dependencies:

    sudo apt-get install libmono-csharp4.0c-cil libmono-microsoft-csharp4.0-cil mono-dmcs mono-mcs

Finalize the installation (for both methods)

Start keepass2 (it should show a dialog while it processes the new plugin) and restart Firefox if you have not already. A dialog should pop up prompting you to authorize KeeFox.

Install the Thunderbird extension

If you want to use KeeFox in Thunderbird, [do so now](en | Thunderbird).

Or if you are using the PPA:

sudo apt-get install xul-ext-keebird