gopass is a password manager for the command line written in Go. It supports all major operating systems (Linux, MacOS, BSD) as well as Windows.

For detailed usage and installation instructions please check out our documentation.

Gopass is a versatile command line based password manager that is being developed with the following principles in mind:

• Easy: For technical users (i.e. those who are used to the command line) it should be easy to get started with gopass.
• Secure: Security is hard. We aim to make it as easy as possible while still providing a good level of protection against common adversaries. Caution: If your personal threat level is very high, we might not offer a good tool for you.
• Extensible: While Gopass includes a fair amount of useful features, we can't cover every use-case. To support more special use cases we want to provide a clean and simple API to integration gopass into your own binaries.

Please see docs/features.md for an extensive list of all features along with several usage examples. Some examples are available in our example password store.

Please see docs/setup.md.

If you have Go 1.16 (or greater) installed:

go get github.com/gopasspw/gopass

WARNING: Please prefer releases, unless you want to contribute to the development of gopass. The master branch might not be very well tested and can contain breaking changes without further notice.

Either initialize a new git repository or clone an existing one.

$ 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.

$ gopass clone [email protected]:john/passwords.git

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

🌟 Welcome to gopass!
🌟 Cloning an existing password store from "[email protected]:john/passwords.git" ...
⚠ Cloning git repository "[email protected]:john/passwords.git" to "/home/john/.local/share/gopass/stores/root" ...
⚠ Configuring git repository ...
🎩 Gathering information for the git repository ...
🚶 What is your name? [John Doe]: 
📧 What is your email? [[email protected]]: 
Your password store is ready to use! Have a look around: `gopass list`

To use the self-updater run:

gopass update

or to upgrade with Go installed, run:

go get -u github.com/gopasspw/gopass

Otherwise, use the setup docs mentioned in the installation section to reinstall the latest version.

This project uses GitHub Flow. In other words, create feature branches from master, open an PR against master, and rebase onto master if necessary.

We aim for compatibility with the latest stable Go Release only.

While this project is maintained by volunteers in their free time we aim to triage issues weekly and release a new version at least every quarter.

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.

gopass is developed in the open. Here are some of the channels we use to communicate and contribute:

• Issue tracker: Use the GitHub issue tracker to file bugs and feature requests.

• gopassbridge: Browser plugin for Firefox, Chrome and other Chromium based browsers
• kubectl gopass: Kubernetes / kubectl plugin to support reading and writing secrets directly from/to gopass.
• gopass alfred: Alfred workflow to use gopass from the Alfred Mac launcher
• git-credential-gopass: Integrate gopass as an git-credential helper
• gopass-hibp: haveibeenpwned.com leak checker
• gopass-jsonapi: native messaging for browser plugins, e.g. gopassbridge
• gopass-summon-prover: gopass as a summon provider
• terraform-provider-gopass: a Terraform provider to interact with gopass
• chezmoi: dotfile manager with gopass support

• Pass - Password Store - iOS, source code, supports only 1 repository now
• Password Store - Android

We welcome any contributions. Please see the CONTRIBUTING.md file for instructions on how to submit changes.

• Security, Known Limitations, and Caveats
• Configuration
• FAQ
• JSON API
• Gopass as Summon provider

• gopass cheat sheet (source on github)
• gopass presentation (source on github)