Skip to content

Commit 5c59c79

Browse files
committed
add FAQ entry for accessing OSX folders
1 parent 9f7ceef commit 5c59c79

File tree

1 file changed

+24
-4
lines changed

1 file changed

+24
-4
lines changed

docs/FAQ.md

+24-4
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,7 @@
3030
- [How does the config file work?](#how-does-the-config-file-work)
3131
- [Isn't an install script piped into sh insecure?](#isnt-an-install-script-piped-into-sh-insecure)
3232
- [How do I make my keyboard shortcuts work?](#how-do-i-make-my-keyboard-shortcuts-work)
33+
- [How do I access my Documents/Downloads/Desktop folders in code-server on OSX?](#how-do-i-access-my-documentsdownloadsdesktop-folders-in-code-server-on-osx)
3334
- [Differences compared to Theia?](#differences-compared-to-theia)
3435
- [`$HTTP_PROXY`, `$HTTPS_PROXY`, `$NO_PROXY`](#http_proxy-https_proxy-no_proxy)
3536
- [Enterprise](#enterprise)
@@ -38,7 +39,7 @@
3839

3940
## Questions?
4041

41-
Please file all questions and support requests at https://github.com/cdr/code-server/discussions.
42+
Please file all questions and support requests at <https://github.com/cdr/code-server/discussions>.
4243

4344
## iPad Status?
4445

@@ -97,7 +98,7 @@ code-server --install-extension <extension id>
9798
## How can I request a missing extension?
9899

99100
We are currently in the process of transitioning to [Open VSX](https://open-vsx.org/).
100-
Once https://github.com/eclipse/openvsx/issues/249
101+
Once <https://github.com/eclipse/openvsx/issues/249>
101102
is implemented, we can fully make this transition. Therefore, we are no longer
102103
accepting new requests for extension requests.
103104

@@ -139,7 +140,7 @@ While you can technically use Microsoft's marketplace with these, please do not
139140
is against their terms of use. See [above](#differences-compared-to-vs-code) and this
140141
discussion regarding the use of the Microsoft URLs in forks:
141142

142-
https://github.com/microsoft/vscode/issues/31168#issue-244533026
143+
<https://github.com/microsoft/vscode/issues/31168#issue-244533026>
143144

144145
See also [VSCodium's docs](https://github.com/VSCodium/vscodium/blob/master/DOCS.md#extensions--marketplace).
145146

@@ -250,7 +251,7 @@ ensure your reverse proxy forwards that information if you are using one.
250251
251252
HTTP servers should strive to use relative URLs to avoid needed to be coupled to the
252253
absolute path at which they are served. This means you must use trailing slashes on all
253-
paths with subpaths. See https://blog.cdivilly.com/2019/02/28/uri-trailing-slashes
254+
paths with subpaths. See <https://blog.cdivilly.com/2019/02/28/uri-trailing-slashes>
254255
255256
This is really the "correct" way things work and why the striping of the base path is the
256257
default. If your application uses relative URLs and does not assume the absolute path at
@@ -400,6 +401,25 @@ This will install a Chrome PWA and now all keybindings will work!
400401

401402
For other browsers you'll have to remap keybindings unfortunately.
402403

404+
## How do I access my Documents/Downloads/Desktop folders in code-server on OSX?
405+
406+
Newer versions of macOS require permission through a non-UNIX mechanism for access to the Desktop, Documents, Pictures, Downloads, and other folders.
407+
408+
You may have to give Node "full disk access" since it doesn't implement any of the macOS permission request stuff natively.
409+
410+
1. Find where Node is installed on your machine
411+
412+
```console
413+
➜ ~ which node
414+
/usr/local/bin/node
415+
```
416+
417+
1. Grant Node Full Disk Access:
418+
419+
Open System Preferences > Security & Privacy > Privacy (horizontal) tab > Full Disk Access (vertical) tab > Click the 🔒 to unlock > Click + and select the Node binary you located.
420+
421+
See [#2794](https://github.com/cdr/code-server/issues/2794) for context on this.
422+
403423
## Differences compared to Theia?
404424

405425
[Theia](https://github.com/eclipse-theia/theia) is a browser IDE loosely based on VS Code. It uses the same

0 commit comments

Comments
 (0)