add air-gapped section and vs code to it

EdwardAngert · EdwardAngert · commit 9bec4c7a4557 · 2025-02-11T22:08:55.000Z
diff --git a/docs/admin/air-gapped/index.md b/docs/admin/air-gapped/index.md
@@ -0,0 +1,9 @@
+# Air-gapped
+
+Coder can be deployed in air-gapped or offline environment.
+
+Use the [air-gapped deployments documentation](../../install/offline.md) for
+deployment considerations and configuration, and use the docs in this section
+for more specific reference and tutorials.
+
+<children></children>
diff --git a/docs/admin/air-gapped/vs-code.md b/docs/admin/air-gapped/vs-code.md
@@ -0,0 +1,13 @@
+# Visual Studio Code in air-gapped environments
+
+Many Coder administrators deploy Coder in [air-gapped environments](../../install/offline.md) where the server or workspaces do not have network access to external websites such as `registry.terraform.com` or `code.visualstudio.com`.
+
+## Allow network access to the VS Code Extension Marketplace
+
+If some network access is allowed, you can allow users 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.
+
+## Portable mode
+
+VS Code [Portable mode](https://code.visualstudio.com/docs/editor/portable) is a self-contained, or "portable," installation of VS Code that uses local files for both installation and application data such as extensions.
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -619,6 +619,24 @@
 						}
 					]
 				},
+				{
+					"title": "Air-gapped",
+					"description": "Configure your air-gapped or offline Coder deployment",
+					"path": "./admin/air-gapped/index.md",
+					"icon_path": "./images/icons/plug.svg",
+					"children": [
+						{
+							"title": "Air-gapped configuration",
+							"description": "Run Coder in offline / air-gapped environments",
+							"path": "./install/offline.md"
+						},
+						{
+							"title": "VS Code",
+							"description": "How to use VS Code in your air-gapped deployment",
+							"path": "./admin/air-gapped/vs-code.md"
+						}
+					]
+				},
 				{
 					"title": "Licensing",
 					"description": "Configure licensing for your deployment",
