Skip to content

Instantly share code, notes, and snippets.

Last active September 22, 2023 21:51
Star You must be signed in to star a gist
What would you like to do?
How to set up git to use the GPG Suite

GPG and git on macOS


No need for homebrew or anything like that. Works with and the command line.

  1. Install -- I'd suggest to do a customized install and deselect GPGMail.
  2. Create or import a key -- see below for
  3. Run gpg --list-secret-keys and look for sec, use the key ID for the next step
  4. Configure git to use GPG -- replace the key with the one from gpg --list-secret-keys
git config --global gpg.program /usr/local/MacGPG2/bin/gpg2
git config --global user.signingkey A6B167E1 
git config --global commit.gpgsign true 
  1. Optionally configure annotated tags to be GPG signed
git config --global tag.forceSignAnnotated true
  1. Add this line to ~/.gnupg/gpg-agent.conf
pinentry-program /usr/local/MacGPG2/libexec/
  1. Add this line to ~/.gnupg/gpg.conf

Import key to GPG on another host

% keybase pgp export
% keybase pgp export -q CB86A866E870EE00 | gpg --import
% keybase pgp export -q CB86A866E870EE00 --secret | gpg --allow-secret-key-import --import

Add public GPG key to GitHub

% open
% keybase pgp export -q CB86A866E440EE00 | pbcopy

See Also

Copy link

thanks! works great (macOS big Sur / github desktop 2.6)

Copy link

gfortil commented Aug 11, 2021

gpgconf --kill gpg-agent

This works for me. I completely forgot about restarting it. Thanks :)

Copy link

It appears in Homebrew new directory is /opt/homebrew/bin/pinentry-mac

Copy link

2. git config --global gpg.program /usr/local/bin/gpg

Working. Thanks

Copy link

rifont commented Sep 17, 2023

If you have already followed the instructions on Git to Generate a new GPG key, and you now want to use GPGTools to manage your key in the keychain, you can use this command to export from gpg (which GnuPG uses) and into gpg2 (which GPGTools uses).

> gpg --list-secret-keys
sec   rsa4096 2023-09-16 [SC]
uid           [ unknown] Joe Bloggs <>

> gpg --export-secret-key <YOUR_SECRET_KEY_ID> | gpg2 --import

After running command you will see the key imported into GPG Keychain UI with type sec/pub. I was then able to sign commits automatically via pinentry without entering a password (such as on Github Desktop).


Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment