docs/content/github/authenticating-to-github/managing-commit-signature-verification/associating-an-email-with-your-gpg-key.md

title, intro, redirect_from, versions, topics

title	intro	redirect_from	versions	topics
Associating an email with your GPG key	Your GPG key must be associated with a {% data variables.product.product_name %} verified email that matches your committer identity.	/articles/associating-an-email-with-your-gpg-key /github/authenticating-to-github/associating-an-email-with-your-gpg-key	free-pro-team enterprise-server github-ae * * *	Identity Access management

{% note %}

If you're using a GPG key that matches your committer identity and your verified email address associated with your {% data variables.product.product_name %} account, then you can begin signing commits and signing tags.

{% endnote %}

{% data reusables.command_line.open_the_multi_os_terminal %} {% data reusables.gpg.list-keys-with-note %} {% data reusables.gpg.copy-gpg-key-id %} 4. Enter gpg --edit-key GPG key ID, substituting in the GPG key ID you'd like to use. In the following example, the GPG key ID is 3AA5C34371567BD2:

$ gpg --edit-key <em>3AA5C34371567BD2</em>

5. Enter gpg> adduid to add the user ID details.

$ gpg> adduid

6. Follow the prompts to supply your real name, email address, and any comments. You can modify your entries by choosing N, C, or E. {% data reusables.gpg.private-email %} {% if currentVersion == "free-pro-team@latest" %} For more information, see "Setting your commit email address."{% endif %}

Real Name: <em>Octocat</em>
Email address: <em>octocat@github.com</em>
Comment: <em>GitHub key</em>
Change (N)ame, (C)omment, (E)mail or (O)kay/(Q)uit?

7. Enter O to confirm your selections.
8. Enter your key's passphrase.
9. Enter gpg> save to save the changes

$ gpg> save

10. Enter gpg --armor --export GPG key ID, substituting in the GPG key ID you'd like to use. In the following example, the GPG key ID is 3AA5C34371567BD2:

$ gpg --armor --export <em>3AA5C34371567BD2</em>
# Prints the GPG key, in ASCII armor format

11. Upload the GPG key by adding it to your GitHub account.

Further reading

• "Checking for existing GPG keys"
• "Generating a new GPG key"
• "Using a verified email address in your GPG key"
• "Adding a new GPG key to your GitHub account"
• "Signing commits"
• "Signing tags"