Overview

The slightly more awesome standard UNIX password manager for teams.

Manage your credentials with easy. In a globally distributed team, on multiple devices or fully offline on an air gapped machine.

• Works everywhere - The same user experience on Linux, MacOS, *BSD or Windows
• Built for teams - Built from our experience working in distributed development teams
• Full autonomy - No network connectivity required, unless you want it

How Does It Work?

By default your credentials are encrypted with GPG and versioned in git. This can be customized easily. The primary interface is the command line. Making it an excellent choice for CLI fans, CI/CD systems or anything you can hook it up with. Gopass can also integrate with your browser so you can largely avoid the command line - if you want.

Installation

Necessary prerequisits for running gopass

gopass can operate without any dependencies but most users will want to use it with gpg and git. An external editor is required if you want to be able to use gopass edit.

Installation through package managers

Homebrew (Linux/MacOS)

brew install act

Debian (Ubuntu, Debian, Raspbian, ...)

Warning: Do not install the gopass package for the official repositories. That is a completely different project that has no relation to us.

$ curl https://packages.gopass.pw/repos/gopass/gopass-archive-keyring.gpg | sudo tee /usr/share/keyrings/gopass-archive-keyring.gpg >/dev/null
$ cat << EOF | sudo tee /etc/apt/sources.list.d/gopass.sources
Types: deb
URIs: https://packages.gopass.pw/repos/gopass
Suites: stable
Architectures: all amd64 arm64 armhf
Components: main
Signed-By: /usr/share/keyrings/gopass-archive-keyring.gpg
EOF
$ sudo apt update
$ sudo apt install gopass gopass-archive-keyring

Fedora / RedHat / CentOS

dnf install gopass

Note: You might need to run dnf copr enable daftaupe/gopass first.

Arch Linux

pacmsn -S gopass

Windows

# Chocolatey
choco install gpg4win
choco install gopass
# Alternatively
scopp install gopass

FreeBSD / OpenBSD

cd /usr/ports/security/gopass
make install

Alpine Linux

apk add gopass

Other installation options

Please see docs/setup.md for other options.

From Source

go install github.com/gopasspw/gopass@latest

Note: latest is not a stable release. We recommend to only use released versions.

Manual download

Download the latest release and add the binary to your PATH.

Example usage

# Command structure
gopass [<command>] [options] [args]
# Shortcut for gopass show [<key>]
gopass [<key>]

# Enter the gopass REPL
gopass

# Find all entries matching the search string
gopass find github

# List your store
gopass ls

# List all mounts
gopass mounts

# List all recipients
gopass recipients

# Sync with all remotes
gopass sync

# Setup a new store
gopass setup

First gopass run

$ gopass setup

   __     _    _ _      _ _   ___   ___
 /'_ '\ /'_'\ ( '_'\  /'_' )/',__)/',__)
( (_) |( (_) )| (_) )( (_| |\__, \\__, \
'\__  |'\___/'| ,__/''\__,_)(____/(____/
( )_) |       | |
 \___/'       (_)

🌟 Welcome to gopass!
🌟 Initializing a new password store ...
🌟 Configuring your password store ...
🎮 Please select a private key for encrypting secrets:
[0] gpg - 0xFEEDBEEF - John Doe <[email protected]>
Please enter the number of a key (0-12, [q]uit) (q to abort) [0]: 0
❓ Do you want to add a git remote? [y/N/q]: y
Configuring the git remote ...
Please enter the git remote for your shared store []: [email protected]:john/passwords.git
✅ Configured

Hint: gopass setup will use gpg encryption and git storage by default. Use --crypto=age to use age encryption instead. Or you can opt out of using a versioned store with --storage=fs.

An existing store can be cloned with e.g. gopass clone [email protected]:john/passwords.git.

Screenshot

Support

Please ask on Slack.

Contributing

We welcome any contributions. Please see the CONTRIBUTING.md for more information.

Credit & License

gopass is licensed under the terms of the MIT license. You can find the complete text in LICENSE.

Please refer to the Git commit log for a complete list of contributors.