Commit cb5e7858 authored by Tails developers's avatar Tails developers
Browse files

Rework the KeePassX documentation

  - Write a more informative and task-oriented intro.
  - Apply documentation styling.
  - Use 'single' instead of 'one' to denote uniqueness.
  - Add anchors and table-of-content.
  - Write an introductory sentence for each section.
  - Put the KeePassX Handbook in a section of its own.
  - Use 'start Tails' instead of 'boot Tails'.
  - Do not use 'prompt'.
  - Limit the usage of 'your'.
  - Mention the error message in case of wrong passphrase.
  - Remove 'how to' in section headings.
  - Use 'Click OK' instead of 'Click the OK button'.
parent 564cb7fc
- [[!traillink Protection_against_cold_boot_attacks|advanced_topics/cold_boot_attacks]]
- [[!traillink Virtualization|advanced_topics/virtualization]]
- [[!traillink Enable_MAC_Changer|advanced_topics/mac_changer]]
- [[!traillink Manage_passwords|advanced_topics/manage_passwords]]
- [[!traillink Manage_passwords_using_<span_class="application">KeePassX</span>|advanced_topics/manage_passwords]]
[[!meta title="Manage passwords"]]
[[!meta title="KeePassX password manager"]]
Tails includes the <span class="application">KeePassX Password
Manager</span>.
[[!toc]]
<span class="application">KeePassX</span> helps you to manage your
passwords in a secure way. You can put all your passwords in one
encrypted database, which is protected with one master passphrase.
So you only have to remember one single master passphrase to unlock
the whole database.
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.
That way, you can always **use different and stronger passwords** since
you only have to remember a single passphrase to unlock the entire
database.
How to create a persistent password database
============================================
Using KeePassX requires a Persistent Volume. If you have not
created a Persistent Volume yet, follow [[the persistence
documentation|first_steps/persistence]] first.
You can also use <span class="application">KeePassX</span> to **generate
strong random passwords**.
0. [[Enable your Persistent Volume|first_steps/persistence/use]].
<a name="create"></a>
0. To make sure the *Personal Data* feature is enabled,
use [[the persistence assistant|first_steps/persistence/configure]].
Create and save a password database
===================================
0. If you had to enable the *Personal Data* feature because it was
previously disabled: restart Tails and [[enable your Persistent
Volume|first_steps/persistence/use]] again.
Follow these steps to create a new password database and save it in the
persistent volume for use in future working sessions.
0. To start KeePassX, choose
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>
feature 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">
0. To create a new password database, choose <span class="menuchoice">
<span class="guimenu">File</span>&nbsp;▸
<span class="guimenuitem">New Database</span></span>.
* The password database is encrypted and protected by
a passphrase.
Specify a passphrase of your choice on the <span
class="guilabel">Password</span> text box.
* Specify the same passphrase again when prompted.
0. To make the password database persist for the next times you start
Tails:
<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 folders list.
* Click the <span class="guilabel">Save</span> button.
* Select `Persistent` in the list of folders in the left pane.
* Click <span class="guilabel">Save</span>.
To learn more about <span class="application">KeePassX</span>, read the
[[official <span class="application">KeePassX</span> user
guide|manage_passwords#user_guide]].
0. Close KeePassX.
<a name="restore"></a>
How to use the persistent password database
===========================================
Restore and unlock the password database
========================================
0. Boot Tails and [[enable your Persistent
Volume|first_steps/persistence/use]].
Follow this steps to unlock the password database saved in the
persistent volume from a previous working session.
0. To start KeePassX, choose
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. When KeePassX starts, you should be prompted for the passphrase
that protects the password database.
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. To learn how to use KeePassX, choose:
<span class="menuchoice">
<span class="guimenu">Help</span>&nbsp;▸
<span class="guimenuitem">KeePassX Handbook</span></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 of the file is damaged.</span>
Then click <span class="guilabel">OK</span> and try again.
<a name="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>.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment