From 03bd95405b3398691c64d16b02783b6dce214c18 Mon Sep 17 00:00:00 2001 From: Thorsten Ball Date: Mon, 28 Oct 2024 14:14:51 +0100 Subject: [PATCH] docs: Add diagram to remote development docs (#19827) Release Notes: - N/A --- docs/src/remote-development.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/src/remote-development.md b/docs/src/remote-development.md index 708d0e0b39..9dc1777f39 100644 --- a/docs/src/remote-development.md +++ b/docs/src/remote-development.md @@ -8,6 +8,10 @@ Remote Development allows you to code at the speed of thought, even when your co Remote development requires two computers, your local machine that runs the Zed UI and the remote server which runs a Zed headless server. The two communicate over SSH, so you will need to be able to SSH from your local machine into the remote server to use this feature. +![Architectural overview of Zed Remote Development](https://zed.dev/img/remote-development/diagram.png) + +On your local machine, Zed runs its UI, talks to language models, uses Tree-sitter to parse and syntax-highlight code, and store unsaved changes and recent projects. The source code, language servers, tasks, and the terminal all run on the remote server. + > **Note:** The original version of remote development sent traffic via Zed's servers. As of Zed v0.157 you can no-longer use that mode. ## Setup @@ -15,7 +19,7 @@ Remote development requires two computers, your local machine that runs the Zed 1. Download and install the latest [Zed Preview](https://zed.dev/releases/preview). You need at least Zed v0.159. 1. Open the remote projects dialogue with cmd-shift-p remote or cmd-control-o. 1. Click "Connect New Server" and enter the command you use to SSH into the server. See [Supported SSH options](#supported-ssh-options) for options you can pass. -1. Your local machine will attempt to connect to the remote server using the `ssh` binary on your path. Assuming the connection is successful, it will download the latest version of the Zed server and upload it to the remote over SSH. +1. Your local machine will attempt to connect to the remote server using the `ssh` binary on your path. Assuming the connection is successful, Zed will download the server on the remote host and start it. 1. Once the Zed server is running, you will be prompted to choose a path to open on the remote server. > **Note:** Zed does not currently handle opening very large directories (for example, `/` or `~` that may have >100,000 files) very well. We are working on improving this, but suggest in the meantime opening only specific projects, or subfolders of very large mono-repos.