diff options
Diffstat (limited to 'wikipages')
| -rw-r--r-- | wikipages/password-store.wiki | 88 |
1 files changed, 88 insertions, 0 deletions
diff --git a/wikipages/password-store.wiki b/wikipages/password-store.wiki new file mode 100644 index 0000000..7953f00 --- /dev/null +++ b/wikipages/password-store.wiki @@ -0,0 +1,88 @@ +<!-- + author: erxeto + title: password store + description: command line, GnuPG base, password manager. +--> + +<h2>pass, cli password manager</h2> + +<p><code>pass</code> is a command line utility to manage your passwords.</p> +<p> +It creates a simple file/folder structure under your $PASSWORD_STORE_DIR (by default <code>~/.password-store</code>) where every file is encrypted with your gpg key. +</p> + +<p> +You can organize that hierarchy as you see fit. For instance something like <code>sites/tilde.news/myusername</code> is a common way of doing it. +</p> + +<p> +Those files are not limited to contain simply a password, they can contain anything. But is recommended that the password goes alone in the first line, so you can benefit from the <code>-c</code> option which copies that to the clipboard directly. +</p> + +<p> +There is bash, zsh and fish command line completion available and all can be tracked using git. So it's really convenient. +</p> + +<h2>setup</h2> +<p>This is simple, just one command (assuming you have your GnuPG key ready). GPG-ID is the hex id of your key.</p> +<div class="code"> +$ pass init GPG-ID +mkdir: created directory ‘/home/user/.password-store’ +Password store initialized for GPG-ID +</div> + + +<h2>basic usage</h2> + +<p> +list all passwords "tree" style +</p> +<div class="code"> +$ pass +Password Store +├── sites +│ ├── tilde.zone +│ │ ├── myUserName +│ │ ├── secondAccount +... +</div> +<p>find a password</p> +<div class="code"> +$ pass find tilde.zone +Search Terms: tilde.zone +└── sites + └── tilde.zone + └── myUserName@tilde.zone +</div> +<p>See the content of a file</p> +<div class="code"> + $ pass email/tilde.institute/myAccount + supersecret +</div> +<p>Copy the first line to the clipboard. Clear time can be configured with <code>$PASSWORD_STORE_CLIP_TIME</code></p> +<div class="code"> + $ pass -c email/tilde.institute/myAccount + Copied email/tilde.institute/myAccount to clipboard. Will clear in 45 seconds. +</div> +<p>Insert a new password. It can be multiline with <code>-m</code>. Remember to put the password on the first line if you want to use the clipboard function</p> +<div class="code"> + $ pass insert sites/foo.com/blah + Enter password for sites/foo.com/blah: +</div> +<p>Generate a 32 chars random password and store it. You can define the default length with <code>$PASSWORD_STORE_GENERATED_LENGTH</code>. With <code>-n</code> the password will not include symbols, but alphanumeric characters only. With <code>-c</code> it gets copied to the clipboard as usual.</p> +<div class="code"> + $ pass generate sites/foo.com/abcd 32 + The generated password to sites/foo.com/abcd is: + $(-QF&Q=IN2nFBx) +</div> + +<p>take a look at the <code>--help</code> option or the complete documentation on their website.</p> + +<p> +references: +<ul> + <li><a href="https://www.passwordstore.org/" target="_blank">pass home page</a></li> +</ul> +</p> + +<a href="/wiki">Back to Wiki</a> |