Supported operating systems

You can use GitHub Desktop on any supported operating system.

In this article

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.

About supported operating systems

The following operating systems are supported for GitHub Desktop.

  • macOS 10.10 or later
  • Windows 7 64-bit or later. You must have a 64-bit operating system to run GitHub Desktop.

Troubleshooting problems on macOS

If you're encountering problems using GitHub Desktop on macOS, here are resolutions to try. For more information, see known-issues.

The username or passphrase you entered is not correct error after signing into your account

This error can occur when GitHub Desktop can't access your stored credentials on Keychain.

To troubleshoot this error, follow these steps.

  1. Open the "Keychain Access" app.
  2. Right-click on login and then click Lock Keychain "login".
    The "Lock Keychain "login" option
  3. Right-click on login and then click Unlock Keychain "login". Follow any onscreen prompts to finish unlocking the Keychain "login."
    The "Unlock Keychain "login" option
  4. Re-authenticate your account on GitHub or GitHub Enterprise.

Could not create temporary directory: Permission denied error after checking for updates

This error can be caused by missing permissions for the ~/Library/Caches/com.github.GitHubClient.ShipIt directory. GitHub Desktop uses this directory to create and unpack temporary files as part of updating the application.

To troubleshoot this error, follow these steps.

  1. Close GitHub Desktop.
  2. Open "Finder" and navigate to ~/Library/Caches/.
  3. Right-click com.github.GitHubClient.ShipIt and then click Get Info.
  4. Click the arrow to the left of "Sharing & Permissions."
  5. If the Privilege to the right of your user account does not say "Read & Write," click the text and then click Read & Write.
    The "Sharing & Permissions" options
  6. Open GitHub Desktop and check for updates.

Troubleshooting problems on Windows

If you're encountering problems using GitHub Desktop on Windows, here are resolutions to try. For more information, see known-issues.

The revocation function was unable to check revocation for the certificate. error

This error can occur if you are using GitHub Desktop on a corporate network that blocks Windows from checking the revocation status of a certificate.

To troubleshoot, contact your system administrator.

git clone failed error while cloning a repository configured with Folder Redirection

GitHub Desktop does not support repositories configured with Folder Redirection.

cygheap base mismatch detected error

This error can occur when Mandatory ASLR is enabled. Enabling Mandatory ASLR affects the MSYS2 core library, which GitHub Desktop relies upon to emulate process forking.

To troubleshoot this error, either disable Mandatory ASLR or explicitly allow all executables under <Git>\usr\bin which depend on MSYS2.

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.