Skip to content

Commit

Permalink
[docs] add new section for org repos (#552)
Browse files Browse the repository at this point in the history
  • Loading branch information
shiftkey authored Jul 6, 2021
1 parent 76ad8c7 commit ec3ed2c
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions docs/known-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@
- [Authentication errors due to modified registry entries](#authentication-errors-due-to-modified-registry-entries)
- [Linux](#linux)
- [I get a white screen when launching Desktop](#i-get-a-white-screen-when-launching-desktop)
- [I cannot access repositories under my organization](#i-cannot-access-repositories-under-my-organization)

# Known Issues

Expand Down Expand Up @@ -244,3 +245,20 @@ Check to see if there is an `Autorun` value in either of those location. If ther
Electron enables hardware accelerated graphics by default, but some graphics cards have issues with hardware acceleration which means the application will launch successfully but it will be a white screen. If you are running GitHub Desktop within virtualization software like Parallels Desktop, hardware accelerated graphics may not be available.

**Workaround:** if you set the `GITHUB_DESKTOP_DISABLE_HARDWARE_ACCELERATION` environment variable to any value and launch Desktop again it will disable hardware acceleration on launch, so the application is usable.

### I cannot access repositories under my organization

The GitHub Desktop application is an OAuth application, but this fork does not
have the same permissions as the app does on Windows and macOS, which manifests
in a couple of different ways:

- the "Clone a Repository" view does not show all organization repositories
- pushes to a repository owned by an organization may be rejected with a
generic error message

The root cause of this is organizations by default will have "OAuth App access
restrictions" enabled, which blocks the GitHub Desktop development app that is
used by this fork.

**Workaround:** ask your organization admin to [approve access](https://docs.github.com/en/organizations/restricting-access-to-your-organizations-data/approving-oauth-apps-for-your-organization)
to the GitHub Desktop development app.

0 comments on commit ec3ed2c

Please sign in to comment.