You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
-[Commits and commit history](#commits-and-commit-history)
8
+
-[Development workflow](#development-workflow)
9
+
-[Update VS Code](#update-vs-code)
10
+
-[Build](#build)
11
+
-[Test](#test)
12
+
-[Unit tests](#unit-tests)
13
+
-[Integration Tests](#integration-tests)
14
+
-[End-to-end tests](#end-to-end-tests)
15
+
-[Structure](#structure)
16
+
-[Modifying VS Code](#modifying-vs-code)
17
+
-[Currently Known Issues](#currently-known-issues)
19
18
20
19
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
21
20
@@ -75,8 +74,7 @@ yarn watch
75
74
76
75
### Update VS Code
77
76
78
-
Updating VS Code requires `git subtree`. On some RPM-based Linux distros, `git
79
-
subtree` is not included by default and needs to be installed separately. To
77
+
Updating VS Code requires `git subtree`. On some RPM-based Linux distros, `git subtree` is not included by default and needs to be installed separately. To
80
78
install, run `dnf install git-subtree` or `yum install git-subtree`.
Copy file name to clipboardExpand all lines: docs/FAQ.md
+27-29
Original file line number
Diff line number
Diff line change
@@ -2,33 +2,32 @@
2
2
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
3
3
# FAQ
4
4
5
-
-[FAQ](#faq)
6
-
-[Questions?](#questions)
7
-
-[How should I expose code-server to the internet?](#how-should-i-expose-code-server-to-the-internet)
8
-
-[Can I use code-server on the iPad?](#can-i-use-code-server-on-the-ipad)
9
-
-[How does the config file work?](#how-does-the-config-file-work)
10
-
-[How do I make my keyboard shortcuts work?](#how-do-i-make-my-keyboard-shortcuts-work)
11
-
-[Why can't code-server use Microsoft's extension marketplace?](#why-cant-code-server-use-microsofts-extension-marketplace)
12
-
-[How can I request an extension that's missing from the marketplace?](#how-can-i-request-an-extension-thats-missing-from-the-marketplace)
13
-
-[How do I install an extension?](#how-do-i-install-an-extension)
14
-
-[How do I install an extension manually?](#how-do-i-install-an-extension-manually)
15
-
-[How do I use my own extensions marketplace?](#how-do-i-use-my-own-extensions-marketplace)
16
-
-[Where are extensions stored?](#where-are-extensions-stored)
17
-
-[How can I reuse my VS Code configuration?](#how-can-i-reuse-my-vs-code-configuration)
18
-
-[How does code-server decide what workspace or folder to open?](#how-does-code-server-decide-what-workspace-or-folder-to-open)
19
-
-[How do I access my Documents/Downloads/Desktop folders in code-server on macOS?](#how-do-i-access-my-documentsdownloadsdesktop-folders-in-code-server-on-macos)
20
-
-[How do I direct server-side requests through a proxy?](#how-do-i-direct-server-side-requests-through-a-proxy)
21
-
-[How do I debug issues with code-server?](#how-do-i-debug-issues-with-code-server)
22
-
-[What is the healthz endpoint?](#what-is-the-healthz-endpoint)
23
-
-[What is the heartbeat file?](#what-is-the-heartbeat-file)
24
-
-[How do I change the password?](#how-do-i-change-the-password)
25
-
-[Can I store my password hashed?](#can-i-store-my-password-hashed)
-[Can I use Docker in a code-server container?](#can-i-use-docker-in-a-code-server-container)
28
-
-[How do I disable telemetry?](#how-do-i-disable-telemetry)
29
-
-[What's the difference between code-server and Theia?](#whats-the-difference-between-code-server-and-theia)
30
-
-[What's the difference between code-server and VS Code Codespaces?](#whats-the-difference-between-code-server-and-vs-code-codespaces)
31
-
-[Are there community projects involving code-server?](#are-there-community-projects-involving-code-server)
5
+
-[Questions?](#questions)
6
+
-[How should I expose code-server to the internet?](#how-should-i-expose-code-server-to-the-internet)
7
+
-[Can I use code-server on the iPad?](#can-i-use-code-server-on-the-ipad)
8
+
-[How does the config file work?](#how-does-the-config-file-work)
9
+
-[How do I make my keyboard shortcuts work?](#how-do-i-make-my-keyboard-shortcuts-work)
10
+
-[Why can't code-server use Microsoft's extension marketplace?](#why-cant-code-server-use-microsofts-extension-marketplace)
11
+
-[How can I request an extension that's missing from the marketplace?](#how-can-i-request-an-extension-thats-missing-from-the-marketplace)
12
+
-[How do I install an extension?](#how-do-i-install-an-extension)
13
+
-[How do I install an extension manually?](#how-do-i-install-an-extension-manually)
14
+
-[How do I use my own extensions marketplace?](#how-do-i-use-my-own-extensions-marketplace)
15
+
-[Where are extensions stored?](#where-are-extensions-stored)
16
+
-[How can I reuse my VS Code configuration?](#how-can-i-reuse-my-vs-code-configuration)
17
+
-[How does code-server decide what workspace or folder to open?](#how-does-code-server-decide-what-workspace-or-folder-to-open)
18
+
-[How do I access my Documents/Downloads/Desktop folders in code-server on macOS?](#how-do-i-access-my-documentsdownloadsdesktop-folders-in-code-server-on-macos)
19
+
-[How do I direct server-side requests through a proxy?](#how-do-i-direct-server-side-requests-through-a-proxy)
20
+
-[How do I debug issues with code-server?](#how-do-i-debug-issues-with-code-server)
21
+
-[What is the healthz endpoint?](#what-is-the-healthz-endpoint)
22
+
-[What is the heartbeat file?](#what-is-the-heartbeat-file)
23
+
-[How do I change the password?](#how-do-i-change-the-password)
24
+
-[Can I store my password hashed?](#can-i-store-my-password-hashed)
-[Can I use Docker in a code-server container?](#can-i-use-docker-in-a-code-server-container)
27
+
-[How do I disable telemetry?](#how-do-i-disable-telemetry)
28
+
-[What's the difference between code-server and Theia?](#whats-the-difference-between-code-server-and-theia)
29
+
-[What's the difference between code-server and VS Code Codespaces?](#whats-the-difference-between-code-server-and-vs-code-codespaces)
30
+
-[Are there community projects involving code-server?](#are-there-community-projects-involving-code-server)
32
31
33
32
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
34
33
@@ -63,8 +62,7 @@ The default config defines the following behavior:
63
62
- Enable password authorization
64
63
- Do not use TLS
65
64
66
-
Each key in the file maps directly to a `code-server` flag (run `code-server
67
-
--help` to see a listing of all the flags). Any flags passed to `code-server`
65
+
Each key in the file maps directly to a `code-server` flag (run `code-server --help` to see a listing of all the flags). Any flags passed to `code-server`
68
66
will take priority over the config file.
69
67
70
68
You can change the config file's location using the `--config` flag or
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/cfg/setup/config.deb.txt?distro=debian&version=any-version' | sudo tee -a /etc/apt/sources.list.d/caddy-stable.list
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/cfg/setup/config.deb.txt?distro=debian&version=any-version' | sudo tee -a /etc/apt/sources.list.d/caddy-stable.list
123
+
sudo apt update
124
+
sudo apt install caddy
125
+
```
127
126
128
127
1. Replace `/etc/caddy/Caddyfile` using `sudo` so that the file looks like this:
129
128
@@ -158,9 +157,9 @@ At this point, you should be able to access code-server via
158
157
1. This option requires that the remote machine be exposed to the internet. Make sure that your instance allows HTTP/HTTP traffic.
159
158
160
159
1. You'll need a domain name (if you don't have one, you can purchase one from
161
-
[Google Domains](https://domains.google.com) or the domain service of your
162
-
choice)). Once you have a domain name, add an A record to your domain that contains your
163
-
instance's IP address.
160
+
[Google Domains](https://domains.google.com) or the domain service of your
161
+
choice)). Once you have a domain name, add an A record to your domain that contains your
162
+
instance's IP address.
164
163
165
164
1. Install NGINX:
166
165
@@ -220,7 +219,7 @@ certificates do not work with iPads and may cause unexpected issues with
220
219
code-server. You should only proceed with this option if:
221
220
222
221
- You do not want to buy a domain or you cannot expose the remote machine to
223
-
the internet
222
+
the internet
224
223
- You do not want to use port forwarding via SSH
225
224
226
225
To use a self-signed certificate:
@@ -278,7 +277,7 @@ If you pass a certificate to code-server, it will respond to HTTPS requests and
278
277
redirect all HTTP requests to HTTPS.
279
278
280
279
> You can use [Let's Encrypt](https://letsencrypt.org/) to get a TLS certificate
-[Sharing a self-signed certificate with an iPad](#sharing-a-self-signed-certificate-with-an-ipad)
10
-
-[Access code-server using Servediter](#access-code-server-using-servediter)
11
-
-[Raspberry Pi USB-C network](#raspberry-pi-usb-c-network)
12
-
-[Recommendations](#recommendations)
13
-
-[Known issues](#known-issues)
14
-
-[Workaround for issue with `ctrl+c` not stopping a running process in the terminal](#workaround-for-issue-with-ctrlc-not-stopping-a-running-process-in-the-terminal)
5
+
-[Using the code-server progressive web app (PWA)](#using-the-code-server-progressive-web-app-pwa)
6
+
-[Access code-server with a self-signed certificate on an iPad](#access-code-server-with-a-self-signed-certificate-on-an-ipad)
-[Sharing a self-signed certificate with an iPad](#sharing-a-self-signed-certificate-with-an-ipad)
9
+
-[Access code-server using Servediter](#access-code-server-using-servediter)
10
+
-[Raspberry Pi USB-C network](#raspberry-pi-usb-c-network)
11
+
-[Recommendations](#recommendations)
12
+
-[Known issues](#known-issues)
13
+
-[Workaround for issue with `ctrl+c` not stopping a running process in the terminal](#workaround-for-issue-with-ctrlc-not-stopping-a-running-process-in-the-terminal)
15
14
16
15
<!-- END doctoc generated TOC please keep comment here to allow auto update -->
17
16
@@ -72,7 +71,7 @@ To share a self-signed certificate with an iPad:
72
71
the certificate's location in its logs:
73
72
74
73
```console
75
-
[2020-10-30T08:55:45.139Z] info - Using generated certificate and key for HTTPS: ~/.local/share/code-server/mymbp_local.crt
74
+
[2020-10-30T08:55:45.139Z] info - Using generated certificate and key for HTTPS: ~/.local/share/code-server/mymbp_local.crt
76
75
```
77
76
78
77
2. Send the certificate to the iPad, either by emailing it to yourself or using
@@ -173,8 +172,8 @@ and tricks helpful:
173
172
- See [workaround](#ctrl-c-workaround)
174
173
175
174
Additionally, see [issues in the code-server repo that are tagged with the iPad
0 commit comments