Skip to content

Commit a0bd241

Browse files
committed
Add "annoying admin password prompt" issue to known issues docs
1 parent f688f1a commit a0bd241

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

docs/known-issues.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,21 @@ This issue seems to be caused by missing permissions for the `~/Library/Caches/c
6161
the "Read & Write" permissions
6262
- Start Desktop again and check for updates
6363

64+
### GitHub Desktop prompts admin password to install helper tool very frequently
65+
66+
Related issue: [#13956](https://github.com/desktop/desktop/issues/13956)
67+
68+
Users who use macOS' Migration Assistant to keep their stuff intact when moving to a new computer might run into this problem because the Migration Assistant changes the owner of the `/Applications/GitHub Desktop.app` folder to `root`.
69+
70+
Since GitHub Desktop is able to auto-update by changing the contents of the `/Applications/GitHub Desktop.app` folder, it needs to be able to write to it. If the owner of the folder is not the current user, the user will be prompted for an admin password every time GitHub Desktop tries to update itself.
71+
72+
**Workaround:** you need to restore the ownership and permissions of the application folder to the current user. If your app is located in `/Applications/GitHub Desktop.app`, you can probably do this by just running the following commands in Terminal:
73+
74+
```sh
75+
sudo chown -R ${USER}:staff /Applications/GitHub\ Desktop.app
76+
chmod -R g+w /Applications/GitHub\ Desktop.app
77+
```
78+
6479
## Windows
6580

6681
### Window is hidden after detaching secondary monitor

0 commit comments

Comments
 (0)