BackupConfigFile

Backing Up The KeePass Configuration

• Overview
• What Is Stored In The Configuration
  • KeePass Configuration Data
    • Protected KeePass Configuration Data
• Configuration File Location
• Backup
• Restore
• KeePass Triggers (V2 only)

---

Overview

KeePass stores its configuration in an external file, not in the database. This allows KeePass to retain session settings independent of which database you use, or if you don't have a database open. The configuration file is stored in different locations depending on its use, or the user's requirements.

---

What Is Stored In The Configuration

Everything from window position to plug-in settings are stored in the configuration file. This ensures your plug-ins load correctly and any triggers you have created are loaded ready for use.

KeePass Configuration Data

KeePass data includes:

• Which configuration file to use, you can have multiple
• Recently used files
• Working directories
• Window position and settings
• Hot keys
• Triggers
• Password generator profiles
• Plug-in settings - some older plug-ins may have their own settings repository
• Remote server credentials

Protected KeePass Configuration Data

Certain KeePass data is protected from casual change by the user.

• Triggers
• Password generator profiles
• URL overrides

This data is saved to the Global Configuration File.
When KeePass is installed via the setup program, this file is protected by Windows.

Top

---

Configuration File Location

The user configuration file is called KeePass.config.xml and the default location is in the KeePass directory under the user's "APPDATA" directory.
The easiest way to see this location is to use Windows %APPDATA% environment variable.

1. Open Windows (File) Explorer, or press <Win><R>
2. Type %APPDATA% in the Address box
3. Press Enter
4. Navigate to the KeePass directory

The global configuration file is stored in the same directory as KeePass.exe.
In a default installation this is C:\Program Files\KeePass Password Safe 2, or C:\Program Files\KeePass2x if you have used the MSI installer.

The user configuration file can be stored in other locations as shown on the KeePass Configuration Page

Top

---

Backup

You can copy the file to another location, add it to your backup or image the whole disk. It's up to you what method you use and where you place the backup copy.

Top

---

Restore

To restore the configuration file you need to find the current configuration file and then copy the backup over that file, but you must close KeePass first.

Top

---

KeePass Triggers (V2 only)

Triggers are stored in the configuration file and you can backup and copy them independently of the configuration file.

• Method 1

  1. Open KeePass
  2. Select Tools > Triggers
  3. Select the trigger you want to backup, or select all of them
  4. Click the Tools button and select "Copy Triggers to Clipboard"
  5. Paste the triggers into Notepad etc.

• Method 2

  1. Locate the configuration file as described above (Configuration File Location)
  2. Right click on the configuration file and select "Edit" - or "Open With" and choose an editor.
  3. Scroll down to the "<Triggers>" section.
  4. Copy everything in the "<Triggers>" section and paste it into the document / location of choice.
  5. Close the configuration file without saving it.

Top