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

title, intro, redirect_from, versions

title	intro	redirect_from	versions
Associating an email with your GPG key	Your GPG key must be associated with a {{ site.data.variables.product.product_name }} verified email that matches your committer identity.	/articles/associating-an-email-with-your-gpg-key	free-pro-team enterprise-server * *

{% note %}

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

{% endnote %}

{{ site.data.reusables.command_line.open_the_multi_os_terminal }} {{ site.data.reusables.gpg.list-keys-with-note }} {{ site.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. {{ site.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 save your selections.
8. Enter your key's passphrase.
9. 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

10. 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"