| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 1 | # Linux Password Storage |
| andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 2 | |
| Aaron Dewes | 1fbcd1d | 2023-07-12 01:04:23 | [diff] [blame] | 3 | On Linux, Chromium can store passwords in five ways: |
| andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 4 | |
| Tom Anderson | 761687a | 2023-06-14 17:27:39 | [diff] [blame] | 5 | * GNOME Libsecret |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 6 | * KWallet 4 |
| Tom Anderson | 761687a | 2023-06-14 17:27:39 | [diff] [blame] | 7 | * KWallet 5 |
| Aaron Dewes | 1fbcd1d | 2023-07-12 01:04:23 | [diff] [blame] | 8 | * KWallet 6 |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 9 | * plain text |
| andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 10 | |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 11 | Chromium chooses which store to use automatically, based on your desktop |
| 12 | environment. |
| andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 13 | |
| Tom Anderson | 761687a | 2023-06-14 17:27:39 | [diff] [blame] | 14 | Passwords stored in KWallet are encrypted on disk, and access |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 15 | to them is controlled by dedicated daemon software. Passwords stored in plain |
| Tom Anderson | 761687a | 2023-06-14 17:27:39 | [diff] [blame] | 16 | text are not encrypted. Because of this, when KWallet is |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 17 | in use, any unencrypted passwords that have been stored previously are |
| 18 | automatically moved into the encrypted store. |
| andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 19 | |
| Tom Anderson | 761687a | 2023-06-14 17:27:39 | [diff] [blame] | 20 | Support for using KWallet was added in version 6, but using |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 21 | these (when available) was not made the default mode until version 12. |
| andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 22 | |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 23 | ## Details |
| andybons | 3322f76 | 2015-08-24 21:37:09 | [diff] [blame] | 24 | |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 25 | Although Chromium chooses which store to use automatically, the store to use can |
| 26 | also be specified with a command line argument: |
| 27 | |
| Tom Anderson | 761687a | 2023-06-14 17:27:39 | [diff] [blame] | 28 | * `--password-store=gnome-libsecret` (to use GNOME Libsecret) |
| 29 | * `--password-store=kwallet` (to use KWallet 4) |
| 30 | * `--password-store=kwallet5` (to use KWallet 5) |
| Aaron Dewes | 1fbcd1d | 2023-07-12 01:04:23 | [diff] [blame] | 31 | * `--password-store=kwallet6` (to use KWallet 6) |
| andybons | ad92aa3 | 2015-08-31 02:27:44 | [diff] [blame] | 32 | * `--password-store=basic` (to use the plain text store) |
| 33 | |
| 34 | Note that Chromium will fall back to `basic` if a requested or autodetected |
| 35 | store is not available. |
| 36 | |
| 37 | In versions 6-11, the store to use was not detected automatically, but detection |
| 38 | could be requested with an additional argument: |
| 39 | |
| 40 | * `--password-store=detect` |
