diff --git a/.github/ranger.yml b/.github/ranger.yml index a756c6662..e1abce2c1 100644 --- a/.github/ranger.yml +++ b/.github/ranger.yml @@ -8,6 +8,8 @@ default: # Default comment to post when an issue is first marked with a closing label comment: "⚠️ This issue has been marked $LABEL and will be closed in $DELAY." + close-faster: + delay: "1 minute" labels: duplicate: close @@ -23,3 +25,15 @@ labels: action: comment delay: 5s message: "Thanks for making your first contribution! :slightly_smiling_face:" + extension-request: + action: close-faster + delay: 5s + message: > + Thanks for opening an extension request! + We are currently in the process of switching extension + marketplaces and transitioning over to [Open VSX](https://open-vsx.org/). + Once https://github.com/eclipse/openvsx/issues/249 is implemented, we + can fully make this transition. Therefore, we are no longer accepting + new requests for extension requests. We suggest installing the VSIX + file and then installing into code-server as a temporary workaround. + See [docs](https://github.com/cdr/code-server/blob/main/docs/FAQ.md#installing-vsix-extensions-via-the-command-line) for more info." diff --git a/docs/FAQ.md b/docs/FAQ.md index 9b570ff3d..6a569e5da 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -7,7 +7,9 @@ - [Community Projects (awesome-code-server)](#community-projects-awesome-code-server) - [How can I reuse my VS Code configuration?](#how-can-i-reuse-my-vs-code-configuration) - [Differences compared to VS Code?](#differences-compared-to-vs-code) + - [Installing an extension](#installing-an-extension) - [How can I request a missing extension?](#how-can-i-request-a-missing-extension) +- [Installing an extension manually](#installing-an-extension-manually) - [How do I configure the marketplace URL?](#how-do-i-configure-the-marketplace-url) - [Where are extensions stored?](#where-are-extensions-stored) - [How is this different from VS Code Codespaces?](#how-is-this-different-from-vs-code-codespaces) @@ -82,15 +84,43 @@ These are the closed source extensions presently unavailable: For more about the closed source parts of VS Code, see [vscodium/vscodium](https://github.com/VSCodium/vscodium#why-does-this-exist). +### Installing an extension + +Extensions can be installed from the marketplace using the extensions sidebar in +code-server or from the command line: + +```shell +code-server --install-extension +# example: code-server --install-extension wesbos.theme-cobalt2 +``` + ## How can I request a missing extension? -Please open a new issue and select the `Extension request` template. +We are currently in the process of transitioning to [Open VSX](https://open-vsx.org/). +Once https://github.com/eclipse/openvsx/issues/249 +is implemented, we can fully make this transition. Therefore, we are no longer +accepting new requests for extension requests. -If an extension is not available or does not work, you can grab its VSIX from its Github releases or -build it yourself. Then run the `Extensions: Install from VSIX` command in the Command Palette and -point to the .vsix file. +Instead, we suggest one of the following: -See below for installing an extension from the cli. +- [Switch to Open VSX](#how-do-i-configure-the-marketplace-url) now +- Download and [install the extension manually](#installing-an-extension-manually) + +## Installing an extension manually + +If an extension is not available from the marketplace or does not work, you can +grab its VSIX from its GitHub releases or build it yourself. + +Once you have downloaded the VSIX to the remote machine you can either: + +- Run the `Extensions: Install from VSIX` command in the Command Palette. +- Use `code-server --install-extension ` + +You can also download extensions from the command line. For instance, downloading off OpenVSX can be done like this: + +```shell +SERVICE_URL=https://open-vsx.org/vscode/gallery ITEM_URL=https://open-vsx.org/vscode/item code-server --install-extension +``` ## How do I configure the marketplace URL?