From ad4393a6308086813b96fbc27f8523d30299d945 Mon Sep 17 00:00:00 2001 From: Yolan Romailler Date: Fri, 12 Mar 2021 14:42:28 +0100 Subject: [PATCH] Fixing typos (#1834) Thanks to Roel Van de Paar RELEASE_NOTES=n/a Signed-off-by: Yolan Romailler --- docs/setup.md | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) diff --git a/docs/setup.md b/docs/setup.md index 8727325027..672f3722a3 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -22,10 +22,10 @@ key generation if these are available for your platform. #### Ubuntu & Debian ```bash -apt-get install gnupg git rng-tools +apt-get install gnupg2 git rng-tools ``` -_Note:_ installing in Ubuntu 16.04 will require you to install `gnupg2`. +_Note:_ installing on Ubuntu prior to 16.04 and similarly old Debian versions might require you to install `gnupg` instead of `gnupg2`. #### RHEL & CentOS @@ -79,11 +79,6 @@ gpg --list-secret-keys If there is no output, then you don't have any keys. To create a new key: -```bash -gpg --gen-key -``` - -For macOS you have to use the following to get all options ```bash gpg --full-generate-key ``` @@ -115,9 +110,14 @@ touch foo git add foo git commit -S -m "test" ``` - +Here the `-S` flag will sign your commit using GPG, allowing you to test your GPG setup with git. If the last step fails please investigate this before continuing. +Also if you have both `gnupg` and `gnupg2` installed, make sure to use the latter in git: +```bash +git config --global gpg.program gpg2 +``` + ## Installation Steps Depending on your operating system, you can either use a package manager, download a pre-built binary, or install from source. If you have a working Go development environment, we recommend building from source. @@ -132,7 +132,7 @@ brew install gopass Alternatively, you can install gopass from the appropriate Darwin release from the repository [releases page](https://github.com/gopasspw/gopass/releases). -If you're using a password on your gpg key, you also have to install pinentry-mac from brew and configure it in your ~/gpg/gpg-agent.conf +If you're using a password on your GPG key, you also have to install `pinentry-mac` from brew and configure it in your `~/gpg/gpg-agent.conf`: ```bash brew install pinentry-mac @@ -335,7 +335,10 @@ For more detailed instructions, please read: [gopass-jsonapi/README](https://git ### Storing and Syncing your Password Store with Google Drive / Dropbox / etc. -Please be warned that using cloud-based storage may negatively impact to confidentially of your store. However, if you wish to use one of these services, you can do so. +The recommended way to use Gopass is to sync your store with a git repository, preferably a private one, since the name and path of your secrets might reveal information that you'd prefer to keep private. +However, shall you prefer to, you might also use the `noop` storage backend that is meant to store data on a cloud provider instead of a git server. + +Please be warned that using cloud-based storage may negatively impact the confidentiality of your store. However, if you wish to use one of these services, you can do so. For example, to use gopass with [Google Drive](https://drive.google.com):