Skip to content
acidvegasPublic

About

posix password manager πŸ”’

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

7 stars

Watchers

1 watching

Forks

Latest commit

Β 

History

15 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

pass

posix password manager

A very simple password manager that keeps passwords inside gpg encrypted files inside a simple directory tree.

Similar to password-store, but simplified & written in POSIX compliant shell script.

Requirements

Config

Edit the source code to change these settings:

Setting Description
GPG_ID Default GPG key ID to use for encrypting/decrypting (can also be set with the PASS_GPG_ID environment variable)
GPG_OPTS Do not edit this unless you know what you are doing
PASS_DIR Directory to store all password information (can also be set with the PASS_DIR environment variable)

Usage

Command Description
pass Display a directory tree of stored passwords
pass <path> Display password information for <path> or a directory tree of stored passwords if <path> is a directory
pass edit <path> Edit (or create) the password information for <path> using $EDITOR (defaults to nano)
pass gen <len> Generate a random password that is <len> characters long
pass otp <path> Return a 2-Factor-Authentication code for <path> (Last non-empty line of <path> must be a valid otpauth:// URI, algorithm, digits & period parameters are supported)

Note: <path> is not a direct path per se. If the password is stored in $PASS_DIR/www/github.gpg all you have to put is www/github for <path>

For setting up 2FA, you can download the QR code image & use zbar to convert it to a string to get a valid URI.

Pinentry Setup

To keep everything in the command line, make sure you edit your $HOME/.gnupg/gpg-agent.conf to include pinentry-program /usr/bin/pinentry-curses

Editor Note

Some editors write copies of the file you are editing outside of /dev/shm (swap, backup & undo files), which can leak your passwords in plaintext to disk. If you use vim, set EDITOR="vim -n -i NONE -c 'set nobackup nowritebackup noundofile'" to disable them.

SmartCard Support

Using a Smart Card such as a YubiKey with pass simply requires setting up your GPG key to recognize your card.

First, you will need to install scdaemon & enable the service on your system in order to recognize your smartcards. After you set this up, you can check if your card is recognized with the gpg --card-status command.

Edit your GPG key with gpg --edit-key [Your-Key-ID] & run the following commands in the interactive session:

key 1
keytocard
save

Mirrors SuperNETs β€’ GitHub β€’ GitLab β€’ Codeberg

About

posix password manager πŸ”’

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

7 stars

Watchers

1 watching

Forks

Contributors

Languages