Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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.