Skip to content

Commit c9fbcff

Browse files
committed
Rewrite differences in FAQ
- Move differences to the Codespaces section since they apply to both Codespaces and OpenVSCode-Server - Add some important missing differences - Exclude settings sync (not being worked on) - Exclude the plugin API (deprecated) - Exclude certificate support (browsers these days are starting to require trusted certs so better not to recommend using this)
1 parent befa76d commit c9fbcff

File tree

1 file changed

+22
-14
lines changed

1 file changed

+22
-14
lines changed

docs/FAQ.md

+22-14
Original file line numberDiff line numberDiff line change
@@ -390,28 +390,36 @@ Theia doesn't allow you to reuse your existing VS Code config.
390390
## What's the difference between code-server and OpenVSCode-Server?
391391

392392
code-server and OpenVSCode-Server both allow you to access VS Code via a
393-
browser. The two projects also use their own [forks of VS Code](https://github.com/coder/vscode) to
394-
leverage modern VS Code APIs and stay up to date with the upsteam version.
393+
browser. The two projects also use their own [forks of VS
394+
Code](https://github.com/coder/vscode) to leverage modern VS Code APIs and stay
395+
up to date with the upsteam version.
395396

396-
However, OpenVSCode-Server is scoped at only making VS Code available in the web browser.
397-
code-server includes some other features:
398-
399-
- password auth
400-
- proxy web ports
401-
- certificate support
402-
- plugin API
403-
- settings sync (coming soon)
404-
405-
For more details, see [this discussion post](https://github.com/coder/code-server/discussions/4267#discussioncomment-1411583).
397+
However, OpenVSCode-Server is scoped at only making VS Code available as-is in
398+
the web browser. code-server contains additional changes to make the self-hosted
399+
experience better (see the next section for details).
406400

407401
## What's the difference between code-server and GitHub Codespaces?
408402

409403
Both code-server and GitHub Codespaces allow you to access VS Code via a
410404
browser. GitHub Codespaces, however, is a closed-source, paid service offered by
411405
GitHub and Microsoft.
412406

413-
On the other hand, code-server is self-hosted, free, open-source, and
414-
can be run on any machine with few limitations.
407+
On the other hand, code-server is self-hosted, free, open-source, and can be run
408+
on any machine with few limitations.
409+
410+
Specific changes include:
411+
412+
- Password authentication
413+
- The ability to host at sub-paths
414+
- Self-contained web views that do not call out to Microsoft's servers
415+
- The ability to use your own marketplace and collect your own telemetry
416+
- Built-in proxy for accessing ports on the remote machine integrated into
417+
VS Code's ports panel
418+
- [Some other things](https://github.com/coder/code-server/tree/main/patches)
419+
420+
Some of these changes appear very unlikely to ever be adopted by Microsoft.
421+
Some may make their way upstream, further closing the gap, but at the moment it
422+
looks like there will always be some subtle differences.
415423

416424
## Does code-server have any security login validation?
417425

0 commit comments

Comments
 (0)