[[!meta title="Manage passwords with KeePassX"]]

Using the [<span class="application">KeePassX</span>](https://www.keepassx.org/)
password manager you can:

  - Store many passwords in an encrypted database which is protected by
    a single passphrase of your choice.
  - Always use different and stronger passwords, since you only have to
    remember a single passphrase to unlock the entire database.
  - Generate very strong random passwords.

[[!toc]]

<a id="create"></a>

Create and save a password database
===================================

Follow these steps to create a new password database and save it in the
persistent volume for use in future working sessions.

To learn how to create and configure the persistent volume, read the
[[documentation on persistence|first_steps/persistence]].

0. When starting Tails, [[enable the persistent volume|first_steps/persistence/use]].

0. In the [[<span class="application">Persistent Volume
   Assistant</span>|first_steps/persistence/configure]], verify that the
   [[<span class="guilabel">Personal Data</span>
   persistence feature|doc/first_steps/persistence/configure#personal_data]] is activated. If it is deactivated, activate it, restart Tails,
   and [[enable the persistent volume|first_steps/persistence/use]].

0. To start <span class="application">KeePassX</span>, choose
   <span class="menuchoice">
   <span class="guimenu">Applications</span>&nbsp;▸
   <span class="guisubmenu">Accessories</span>&nbsp;▸
   <span class="guimenuitem">KeePassX</span></span>.

0. To create a new password database, choose <span class="menuchoice">
     <span class="guimenu">File</span>&nbsp;▸
     <span class="guimenuitem">New Database&hellip;</span></span>

0. The password database is encrypted and protected by
   a passphrase.
   * Specify a passphrase of your choice in the <span
     class="guilabel">Password</span> text box, then click <span
     class="guilabel">OK</span>.
   * Type the same passphrase again in the next dialog, then click
     <span class="guilabel">OK</span>.

0. To store the password database in the persistent volume for use in
   future working sessions:
   * Choose <span class="menuchoice">
     <span class="guimenu">File</span>&nbsp;▸
     <span class="guimenuitem">Save Database</span></span>.
   * Enter `keepassx` in the <span class="guilabel">Name</span> text box.
   * Select `Persistent` in the list of folders in the left pane.
   * Click <span class="guilabel">Save</span>.

<a id="restore"></a>

Restore and unlock the password database
========================================

Follow these steps to unlock the password database saved in the
persistent volume from a previous working session.

0. When starting Tails, [[enable the persistent volume|first_steps/persistence/use]].

0. To start <span class="application">KeePassX</span>, choose
   <span class="menuchoice">
   <span class="guimenu">Applications</span>&nbsp;▸
   <span class="guisubmenu">Accessories</span>&nbsp;▸
   <span class="guimenuitem">KeePassX</span></span>.

0. If a password database is found in the persistent volume, a dialog
   appears and asks for the passphrase to unlock that password database.
   Enter the passphrase and click <span class="guilabel">OK</span>.

0. If you enter an invalid passphrase the following error message
   appears:

   <span class="guilabel">The following error occured while opening the
   database:<br/>
   Hash test failed.<br/>
   The key is wrong or the file is damaged.</span>

   Then click <span class="guilabel">OK</span> and try again.

<div class="tip">

<p>In addition to the <em>password database</em>, you can store your <span class="application">KeePassX</span>
<em>settings</em>
using the [[<span class="guilabel">Dotfiles</span> persistence
feature|doc/first_steps/persistence/configure#dotfiles]]. To do so, create the folder
<code>/live/persistence/TailsData_unlocked/dotfiles/.config/keepassx/</code>
and copy the file <code>~/.config/keepassx/config.ini</code> to it.</p>

</div>

<a id="user_guide"></a>

<span class="application">KeePassX</span> user guide
====================================================

To read the official <span class="application">KeePassX</span> user
guide, choose
<span class="menuchoice">
<span class="guimenu">Help</span>&nbsp;▸
<span class="guimenuitem">KeePassX Handbook…</span></span>.
