From c9fbcffd5383d6b62c80f9f752255071ac3891ca Mon Sep 17 00:00:00 2001 From: Asher Date: Mon, 27 Feb 2023 14:16:01 -0900 Subject: [PATCH] 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) --- docs/FAQ.md | 36 ++++++++++++++++++++++-------------- 1 file changed, 22 insertions(+), 14 deletions(-) diff --git a/docs/FAQ.md b/docs/FAQ.md index 6cdb92e4f1e5..fe51429b934a 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -390,19 +390,13 @@ Theia doesn't allow you to reuse your existing VS Code config. ## What's the difference between code-server and OpenVSCode-Server? code-server and OpenVSCode-Server both allow you to access VS Code via a -browser. The two projects also use their own [forks of VS Code](https://github.com/coder/vscode) to -leverage modern VS Code APIs and stay up to date with the upsteam version. +browser. The two projects also use their own [forks of VS +Code](https://github.com/coder/vscode) to leverage modern VS Code APIs and stay +up to date with the upsteam version. -However, OpenVSCode-Server is scoped at only making VS Code available in the web browser. -code-server includes some other features: - -- password auth -- proxy web ports -- certificate support -- plugin API -- settings sync (coming soon) - -For more details, see [this discussion post](https://github.com/coder/code-server/discussions/4267#discussioncomment-1411583). +However, OpenVSCode-Server is scoped at only making VS Code available as-is in +the web browser. code-server contains additional changes to make the self-hosted +experience better (see the next section for details). ## What's the difference between code-server and GitHub Codespaces? @@ -410,8 +404,22 @@ Both code-server and GitHub Codespaces allow you to access VS Code via a browser. GitHub Codespaces, however, is a closed-source, paid service offered by GitHub and Microsoft. -On the other hand, code-server is self-hosted, free, open-source, and -can be run on any machine with few limitations. +On the other hand, code-server is self-hosted, free, open-source, and can be run +on any machine with few limitations. + +Specific changes include: + +- Password authentication +- The ability to host at sub-paths +- Self-contained web views that do not call out to Microsoft's servers +- The ability to use your own marketplace and collect your own telemetry +- Built-in proxy for accessing ports on the remote machine integrated into + VS Code's ports panel +- [Some other things](https://github.com/coder/code-server/tree/main/patches) + +Some of these changes appear very unlikely to ever be adopted by Microsoft. +Some may make their way upstream, further closing the gap, but at the moment it +looks like there will always be some subtle differences. ## Does code-server have any security login validation?