Skip to content
This repository has been archived by the owner on Oct 17, 2020. It is now read-only.

en | Getting started

luckyrat edited this page Feb 25, 2014 · 14 revisions

Please open Firefox and then install the KeeFox addon from https://addons.mozilla.org/en-US/firefox/addon/keefox/

Then follow the step by step instructions to setup KeeFox and learn how to use it.

The introductory tutorial for new users can be found at http://tutorial.keefox.org/part1

Downloading

The current stable version of KeeFox can be downloaded from here: https://addons.mozilla.org/en-US/firefox/addon/keefox/

Beta versions are available at https://addons.mozilla.org/en-US/firefox/addon/keefox/versions

Development snapshots (pre-beta) are sometimes available from here: http://keefox.org/download/experimental-version

Please note that the development snapshot / experimental version has only been tested on a single development machine and may not install and/or run as expected. Do not use it in a production environment.

Installing

Most users will be able to simply install the KeeFox addon from the official Firefox addons website and then follow the couple of instructions that KeeFox presents after restarting Firefox.

On Linux, some manual steps are required. See [Installing on Linux](en | Installation | Linux) for the procedure.

If you are unable to troubleshoot installation problems from the tips at the bottom of the getting started tutorial, you may want to read about how to perform a manual installation (see below).

Creating a database

When you first install KeeFox it needs to establish a secure connection to KeePass and during this setup process you are given the opportunity to set up a new password database. The options are deliberately minimised to help you to get a typical database up and running quickly.

If you need to create a new database at a later date you can use the standard KeePass database creation feature which has a few more options but it is understandable if you read the descriptions on the dialog carefully.

You can create a new database in KeePass by pressing the "new database" icon (top left white square with a star) or going to File / New. Further help should be available on the official KeePass help centre.

Importing passwords from other sources

Please see the page on the KeeFox website regarding data migration.

System requirements

Installing the KeeFox add-on through the official Firefox addons site is usually the easiest way to get KeeFox installed but if you need to refer to the system requirements...

Either Firefox 17.0 or higher

Or Thunderbird 17.0 or higher

Windows XP or higher

  • KeePass 2.15 or higher
  • Microsoft .NET 2.0 or higher

Linux

  • KeePass 2.19 or higher
  • Mono 2.10 or higher

Mac OSX

  • Unknown
  • You should find it works if you get the latest version of OSX, Mono and KeePass but it's untested
  • To get KeeFox working on a Mac you must install the KeeFox version from the development channel

KeeFox has not been tested with .NET 4.5 or higher at time of writing but reports from users suggest it works fine (14th January 2013). Ditto for Windows 8 (although obviously there is no support for Metro or RT).

You should use the latest version of KeePass if possible since this is what KeeFox is tested against. Unfortunately, from time to time new versions of KeePass are released which break KeeFox so there may be short periods where running the brand new version of KeePass is not possible.

Manual installation

KeeFox can be installed and configured manually if preferred. Exact steps will depend on your operating system, Firefox version, etc. but the following information should help you see what the end result needs to be in order for KeeFox to function correctly.

Firstly, the KeeFox Firefox add-on needs to be installed. This should be done in the same way as installing any other Firefox add-on.

You also need to install KeePass Password Safe 2. Again, follow standard installation procedures for an application and refer to http://keepass.info if you get stuck at this stage.

You need to then place the KeePassRPC.plgx file into a subfolder of the KeePass installation location called "plugins". This file can be found in the Firefox extension package in the deps folder. A Firefox .xpi is just a zip folder so it might be easiest to just rename the file and browse the contents of the XPI to find the plgx file but you could alternatively choose to find the file in the extracted version of the extension in your Firefox profile directory.

The final step is to make sure that KeeFox knows where to find KeePass. There are text boxes in the "KeePass" tab of the KeeFox options dialog in Firefox where you can enter these details manually but if you have installed KeePass using the standard setup file you should find that KeeFox automatically detects the correct location when Firefox is restarted.

WARNING!

OLD INFORMATION

The information in this Wiki is out of date.

It is only of interest if you are using the old add-on called KeeFox in a very old (insecure) version of Firefox or other browsers based on the old Firefox XUL technology.

Read the manual for Kee and KeeBird instead.

Clone this wiki locally