Skip to content

Document offline behavior with VS Code Remote SSH #8946

Open
@bpmct

Description

@bpmct

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)

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsArea: coder.com/docs

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions