Skip to content

Document offline behavior with VS Code Remote SSH #8946

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
bpmct opened this issue Aug 7, 2023 · 2 comments
Open

Document offline behavior with VS Code Remote SSH #8946

bpmct opened this issue Aug 7, 2023 · 2 comments
Labels
docs Area: coder.com/docs

Comments

@bpmct
Copy link
Member

bpmct commented Aug 7, 2023

Background

Many Coder users deploy Coder in offline scenarios, where the server or workspaces do not have network access to external websites such as registry.terraform.com or code.visualstudio.com.

These customers typically use our VS Code Extension by giving user's desktops network access to code.visualstudio.com. When they connect to a workspace with VS Code Remote SSH, their desktop will download the server and scp it into the workspace. However, I believe the extension doesn't work when the client/server are both entirely offline: microsoft/vscode-remote-release#1242

Must have

  • Test & document whether the extension works when the client/server is entirely offline (e.g. no network access to code.visualstudio.com). I believe it doesn't
  • Document the different ways that vscode-server is installed on the workspace (e.g. via scp or downloaded directly from within the workspace`). Feel free to link to external docs here

Should have

  • Document workarounds for downloading vscode-server manually on the client or workspace. Also document known issues with this approach (e.g. what happens if the client updates their VS Code instance and there is a version mismatch from client/server)
@cdr-bot cdr-bot bot added the docs Area: coder.com/docs label Aug 7, 2023
@bdsoha
Copy link

bdsoha commented Aug 8, 2023

I have deployed an offline http server that mimics the endpoints provided by code.visualstudio.com.
The main issue is that the requested version of vscode-server is not based on a semver but rather a commit hash.

The actual binaries can be downloaded here:


There is also a gist that provided me with a lot of inspiration for the server I deployed on-prem.

@bdsoha
Copy link

bdsoha commented Aug 8, 2023

This is also (indirectly) related to other issues discussing deployments in an offline network:

@matifali matifali added this to the Docs Improvement milestone Dec 20, 2023
@stirby stirby removed this from the Docs Improvement milestone Jun 17, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Area: coder.com/docs
Projects
None yet
Development

Successfully merging a pull request may close this issue.

4 participants