Skip to content

Commit 63bfbe0

Browse files
deepak1556joaomorenontrogh
authored
docs: update faq for linux client and remote (microsoft#6957)
* docs: add remote faq for older linux versions (microsoft#6953) * docs: add remote faq for older linux versions * Update docs/remote/faq.md Co-authored-by: João Moreno <mail@joaomoreno.com> * Update docs/remote/faq.md Co-authored-by: João Moreno <mail@joaomoreno.com> * Update docs/remote/faq.md Co-authored-by: João Moreno <mail@joaomoreno.com> * Update docs/remote/faq.md Co-authored-by: João Moreno <mail@joaomoreno.com> * Update docs/remote/faq.md * Update docs/remote/faq.md * Update docs/remote/faq.md * Update docs/remote/faq.md --------- Co-authored-by: João Moreno <mail@joaomoreno.com> Co-authored-by: Nick Trogh <1908215+ntrogh@users.noreply.github.com> * docs: add client faq for older linux versions (microsoft#6954) * docs: add client faq for older linux versions * Update docs/supporting/faq.md * Update docs/supporting/faq.md * Update docs/supporting/faq.md --------- Co-authored-by: Nick Trogh <1908215+ntrogh@users.noreply.github.com> --------- Co-authored-by: João Moreno <mail@joaomoreno.com> Co-authored-by: Nick Trogh <1908215+ntrogh@users.noreply.github.com>
1 parent e87572d commit 63bfbe0

File tree

3 files changed

+20
-5
lines changed

3 files changed

+20
-5
lines changed

docs/remote/faq.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,12 +101,21 @@ You can use one of the following solutions to resolve this problem:
101101

102102
### What Linux packages or libraries need to be installed on a host to use Remote Development?
103103

104-
Remote Development requires kernel >= 3.10, glibc >=2.17, and libstdc++ >= 3.4.18. Recent x86_64 glibc-based distributions have the best support, but exact requirements can vary by distribution.
104+
Remote Development requires kernel >= 4.18, glibc >=2.28, and libstdc++ >= 3.4.25. Recent x86_64 glibc-based distributions have the best support, but exact requirements can vary by distribution.
105105

106106
Support for musl-based [Alpine Linux](https://alpinelinux.org) is available for the Dev Containers and WSL extensions and ARMv7l (AArch32) / ARMv8l (AArch64) is available in Remote - SSH. However, native dependencies in certain extensions may cause them not to function on non-x86_64 glibc distributions. Note that experimental ARMv8l (AArch64) is available in [VS Code Insiders](https://code.visualstudio.com/insiders/) only.
107107

108108
See [Remote Development with Linux](/docs/remote/linux.md) for additional details.
109109

110+
### Can I run VS Code Server on older Linux distributions?
111+
112+
Starting with VS Code release 1.86, the minimum requirements for the build toolchain of the remote server were raised. The prebuilt servers distributed by VS Code are compatible with Linux distributions based on glibc 2.28 or later, for example, Debian 10, RHEL 8, Ubuntu 20.04.
113+
114+
If your setup does not meet these requirements and you are unable to upgrade the Linux distribution, you can downgrade the VS Code client to version 1.85 to continue using Remote Development. You can downgrade the VS Code client on both desktop and web:
115+
116+
* On desktop, you can download the VS Code release 1.85 from [here](https://code.visualstudio.com/updates/v1_85). Depending on your platform, make sure to disable updates to stay on that version. A good recommendation is to have release 1.85 as a separate installation, set up with [Portable Mode](https://code.visualstudio.com/docs/editor/portable). That way, you won't affect your main desktop VS Code version.
117+
* On web, you can add the following query argument [`?vscode-version=0ee08df0cf4527e40edc9aa28f4b5bd38bbff2b2`](https://vscode.dev/?vscode-version=0ee08df0cf4527e40edc9aa28f4b5bd38bbff2b2) to use VS Code release 1.85.
118+
110119
### Can I install individual extensions instead of the extension pack?
111120

112121
Yes. The [Remote Development extension pack](https://aka.ms/vscode-remote/download/extension) provides a convenient way for you to access all of the latest remote capabilities as they are released. However, you can always install the individual extensions from the Marketplace or VS Code Extensions view.

docs/supporting/faq.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -299,6 +299,12 @@ VS Code desktop version starting with 1.83 (September 2023) is deprecating suppo
299299

300300
VS Code will no longer provide product updates or security fixes on macOS Mojave (versions 10.14 and older) and VS Code version 1.85 will be the last available release for macOS Mojave (10.14 and older). You can learn more about upgrading your macOS version at [support.apple.com](https://support.apple.com/en-us/HT201260).
301301

302+
## Can I run VS Code on older Linux distributions?
303+
304+
Starting with VS Code release 1.86 (January 2024), VS Code desktop is only compatible with Linux distributions based on glibc 2.28 or later, for example, Debian 10, RHEL 8, or Ubuntu 20.04.
305+
306+
If you are unable to upgrade your Linux distribution, the recommended alternative is to use our [web client](/docs/editor/vscode-web.md). If you would like to use the desktop version, then you can download the VS Code release 1.85 from [here](https://code.visualstudio.com/updates/v1_85). Depending on your platform, make sure to disable updates to stay on that version. A good recommendation is to set up the installation with [Portable Mode](/docs/editor/portable.md).
307+
302308
## Technical Support
303309

304310
You can ask questions and search for answers on [Stack Overflow](https://stackoverflow.com/questions/tagged/vscode) and enter issues and feature requests directly in our [GitHub repository](https://github.com/microsoft/vscode/issues).

docs/supporting/requirements.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ VS Code is supported on the following platforms:
2323

2424
* Windows 10 and 11 (64-bit)
2525
* macOS versions with Apple security update support. This is typically the latest release and the two previous versions.
26-
* Linux (Debian): Ubuntu Desktop 18.04, Debian 10
27-
* Linux (Red Hat): Red Hat Enterprise Linux 7, CentOS 7, Fedora 35
26+
* Linux (Debian): Ubuntu Desktop 20.04, Debian 10
27+
* Linux (Red Hat): Red Hat Enterprise Linux 8, Fedora 36
2828

2929
## Not supported
3030

@@ -35,7 +35,7 @@ VS Code is supported on the following platforms:
3535

3636
### Additional Linux requirements
3737

38-
* GLIBCXX version 3.4.21 or later
39-
* GLIBC version 2.17 or later
38+
* GLIBCXX version 3.4.25 or later
39+
* GLIBC version 2.28 or later
4040

4141
For a list of currently known issues, see our [FAQ](faq).

0 commit comments

Comments
 (0)