Configuring Git for GitHub Desktop

If you don't already have Git installed, you must configure it before using GitHub Desktop.

GitHub Desktop uses the email address you set in your local Git configuration to connect commits with your GitHub or GitHub Enterprise account.

Tips:

  • Anyone will be able to see the email address in your Git configuration if you make public commits. For more information, see "Setting your commit email address."
  • Running GitHub Desktop behind a proxy server is not supported. You can configure Git to use proxy settings depending on the server, however, this is not always successful. For more information, see the git-config topic in the Git documentation.
  1. Sign in to GitHub or GitHub Enterprise.

  2. In the upper-right corner of any page, click your profile photo, then click Settings.

    Settings icon in the user bar

  3. In the left sidebar, click Emails.

    Emails tab

  4. Copy the email address you'd like to use in your local Git configuration.

  5. Return to GitHub Desktop.

  6. In the upper-left corner of your screen, select the GitHub Desktop menu.

    The GitHub Desktop menu in the Mac menu bar

  7. Click Preferences.

    The Preferences value in the GitHub Desktop drop-down menu

  8. In the Preferences window, select Git.

    The Git Pane in the Preferences menu

  9. In the Name field, type the name you'd like to use for your Git configuration.

    The name field of the Git configuration

  10. In the Email field, paste the email address you copied from your GitHub or GitHub Enterprise account settings.

    Pasted email address in Git configuration field

  1. Sign in to GitHub or GitHub Enterprise.

  2. In the upper-right corner of any page, click your profile photo, then click Settings.

    Settings icon in the user bar

  3. In the left sidebar, click Emails.

    Emails tab

  4. Copy the email address you'd like to use in your local Git configuration.

  5. Return to GitHub Desktop.

  6. In the upper-left corner of the window, select the File menu.

    The GitHub Desktop menu in the windows menu bar

  7. Click Options.

    The Options value in the Settings drop-down menu

  8. In the Options window, select Git.

    The Git Pane in the Options menu

  9. In the Name field, type the name you'd like to use for your Git configuration.

    The name field of the Git configuration

  10. In the Email field, paste the email address you copied from your GitHub or GitHub Enterprise account settings.

    Pasted email address in Git configuration field

Further reading

Ask a human

Can't find what you're looking for?

Contact us