mirror of
https://gitea.com/mcereda/oam.git
synced 2026-02-09 05:44:23 +00:00
5.5 KiB
5.5 KiB
Gopass
TL;DR
# Installation.
brew install 'gopass'
go install 'github.com/gopasspw/gopass@latest'
go install 'github.com/gopasspw/gopass@v1.15.11'
# Install shell completions.
gopass completion 'fish' > "$HOME/.config/fish/completions/gopass.fish"
source $(gopass completion 'zsh')
# Setup new stores.
# If no options are given, defaults are used.
gopass setup
# Show all configuration values.
gopass config
gopass config --store 'family'
# Show specific configuration values only.
gopass config 'core.autoclip'
gopass config --store='foo' 'core.autopush'
# Update specific configuration values.
gopass config 'core.autopush' false
gopass config --store 'bar' 'generate.generator' 'xkcd'
# Initialize the *root* store.
gopass init
gopass init -p 'path/to/root/store' 'key-id'
# Generate and show passwords in output.
gopass pwgen
gopass pwgen -1 24
gopass pwgen -x --xc --xl 'en' --xn --xs '-' 3
# List entries.
gopass list
# Interactively create secrets.
gopass create
gopass new
# Insert new entries.
gopass insert 'path/to/entry'
gopass insert -m …
# Create new entries with generated passwords.
gopass generate 'path/to/entry'
gopass generate -g 'xkcd' --lang 'en' 'path/to/entry'
# Copy secrets' password to the clipboard.
# Do *not* print secrets out.
gopass show -c 'path/to/entry'
# Edit new or existing secrets.
gopass edit 'path/to/entry'
gopass set …
# Delete entries.
gopass delete 'path/to/entry'
gopass remove -r …
gopass rm …
# Copy entries.
gopass copy 'from' 'to'
gopass cp …
# Move entries.
gopass move 'path/to/old/entry' 'path/to/new/entry'
gopass mv …
# Link entries.
gopass link 'path/to/linked/entry' 'path/to/linking/entry'
gopass ln 'stackexchange.com/me@example.org' 'stackoverflow.com/me@example.org'
# Copy files.
gopass fscopy '/path/to.file' 'path/to/entry'
gopass fscopy 'path/to/entry' '/path/to.file'
# Copy files and remove the source.
gopass fsmove '/path/to.file' 'path/to/entry'
gopass fsmove 'path/to/entry' '/path/to.file'
# Get sha256sum of secrets.
gopass sum 'path/to/entry'
gopass sha …
gopass sha265 …
# Find entries matching the search string.
gopass find 'github'
gopass search …
# Find secrets containing the search string when decrypted.
gopass grep 'search-string'
# List mounted stores.
gopass mounts
# Add (a.k.a mount) existing stores in multi store mode.
# Default command for 'mounts' if missing.
gopass mounts 'internal/path/to/store' 'external/path/to/store'
gopass mounts add …
gopass mounts mount …
# Create and mount stores.
gopass mounts add -c 'internal/path/to/store' 'external/path/to/store'
gopass init -s 'store' -p 'path/to/store'
# Remove (a.k.a unmount) stores.
gopass mounts remove 'internal/path/to/store-1' … 'store-N'
gopass mounts rm …
gopass mounts unmount …
gopass mounts umount …
# List templates.
gopass templates
gopass templates 'path/to/folder'
# Show templates.
gopass templates show 'path/to/folder'
gopass templates cat …
# Create templates.
gopass templates edit 'path/to/folder'
gopass templates create …
gopass templates new …
# Use templates to create new secrets.
gopass edit -c 'path/to/folder/with/template'/'entry'
# Move templates.
mv 'path/to/gopass/repo/path/to/folder/with/template/.pass-template' 'path/to/gopass/repo/path/to/destination'
# Remove templates.
gopass templates remove 'path/to/folder'
gopass templates rm …
# List all recipients.
gopass recipients
# Get the key ID in the format used by gopass.
gpg --list-keys --keyid-format '0xlong'
# Add recipients.
gopass recipients add 'key-id-in-0xlong-format'
gopass recipients add --store 'store' …
# Remove recipients
gopass recipients remove
gopass recipients remove '0xB5B44266A3683834'
gopass recipients remove --store 'store' …
# Check the stores integrity, clean up artifacts and re-encrypt secrets if
# recipients are missing or changed.
gopass fsck
gopass fsck --decrypt
# Sync with remotes.
gopass sync
gopass sync -s 'store-1' … 'store-N'
# Manage git operations manually.
gopass git pull
gopass git push --store='foo' 'origin' 'main'
# Reset gopass' configuration.
rm "${HOME}/.config/gopass/config"
# Remove gopass' default root store.
rm -r "${HOME}/.local/share/gopass/stores/root"
File formats
See secrets, but mostly features.
Browsers integration
Browserpass
brew tap amar1729/formulae
brew install browserpass
for b in chromium chrome vivaldi brave firefox; do
PREFIX='/usr/local/opt/browserpass' make hosts-chrome-user -f /usr/local/opt/browserpass/lib/browserpass/Makefile
done
Troubleshooting
See the FAQ page.
Further readings
- GoPass' website
- GoPass' documentation
- woile's cheatsheet