docs/linux_password_storage.md

   1 # Linux Password Storage
   2
   3 On Linux, Chromium can store passwords in three ways:
   4
   5 *   GNOME Keyring
   6 *   KWallet 4
   7 *   plain text
   8
   9 Chromium chooses which store to use automatically, based on your desktop
  10 environment.
  11
  12 Passwords stored in GNOME Keyring or KWallet are encrypted on disk, and access
  13 to them is controlled by dedicated daemon software. Passwords stored in plain
  14 text are not encrypted. Because of this, when either GNOME Keyring or KWallet is
  15 in use, any unencrypted passwords that have been stored previously are
  16 automatically moved into the encrypted store.
  17
  18 Support for using GNOME Keyring and KWallet was added in version 6, but using
  19 these (when available) was not made the default mode until version 12.
  20
  21 ## Details
  22
  23 Although Chromium chooses which store to use automatically, the store to use can
  24 also be specified with a command line argument:
  25
  26 *   `--password-store=gnome` (to use GNOME Keyring)
  27 *   `--password-store=kwallet` (to use KWallet)
  28 *   `--password-store=basic` (to use the plain text store)
  29
  30 Note that Chromium will fall back to `basic` if a requested or autodetected
  31 store is not available.
  32
  33 In versions 6-11, the store to use was not detected automatically, but detection
  34 could be requested with an additional argument:
  35
  36 *   `--password-store=detect`