Updated: April 20, 2018

Quick Start

  1. Add a new entry to your database (Edit > Add Entry…).
  2. On the Entry tab, give the entry a title (1).
  3. Enter the passphrase for the SSH key you are going to use in the Password field (2). The plugin needs this to decrypt the file. Leave the Password field blank if the key is not encrypted.
  4. On the Advanced tab, attach your private key file using the Attach button (1). Select the key using the file dialog. This can be a PuTTY private key file (.ppk) or an OpenSSH private key file. After you have selected key and clicked OK, the file will appear in the list of attachments (2).
    KeePass - Add Entry - Advanced tab
  5. On the KeeAgent tab, check the box that says Allow KeeAgent to use this entry (1).
  6. In the Location group, the file that you just attached should be automatically selected as the Attachment (2). Verify that this happened. If you have more than one attachment, you may have to select the correct file.
    KeePass - Add Entry - KeeAgent tab
  7. Click OK to save the entry and close the Edit Entry dialog.
    The remaining fields in the Entry, such as User name and URL, are not used by KeeAgent and can be left blank or used for anything you want.
  8. Right-click on the new entry and select Add SSH Key to KeeAgent. The key is now loaded into the agent and can be used by client programs such as PuTTY.
    KeePass - Context Menu - Load SSH Key
  9. Click on Tools > KeeAgent. This displays a list of currently loaded keys and allows you to add or remove keys.
    KeePass - Manage KeeAgent