Zed/ssh

Open a remote project over SSH

Opens a directory on a remote host as a Zed project.

macos · linux · windows · sign-in required · updated 2026-07-12

Format

zed://ssh/{user}@{host}:{port}/{path}

Try it

zed://ssh/deploy@build-01:22/srv/apiOpen

What you supply

{user}optional

SSH user.

Omit it, and the @, to use your SSH config's default for the host.

{host}

Hostname or IP of the remote machine.

{port}optional

SSH port.

Omit it, and the :, for the default port.

{path}

Absolute path of the directory to open on the remote host.

Internally this is rewritten to an ordinary ssh:// URL, and Zed handles bare ssh:// links the same way — so ssh://deploy@build-01:22/srv/api is equivalent and survives being pasted into tools that strip unknown schemes.

Authentication is your existing SSH setup. The link selects a host, it does not configure one: if the host is not reachable with your current keys and config, the link cannot help you.