diff --git a/crates/remote/src/ssh_session.rs b/crates/remote/src/ssh_session.rs
index c50a6766122d465ae1818b69387350e06575c23c..b6c7b6875fabeb59a8b7d5fa979fee7408e36db4 100644
--- a/crates/remote/src/ssh_session.rs
+++ b/crates/remote/src/ssh_session.rs
@@ -1549,14 +1549,18 @@ impl SshRemoteConnection {
         let os = match os.trim() {
             "Darwin" => "macos",
             "Linux" => "linux",
-            _ => Err(anyhow!("unknown uname os {os:?}"))?,
+            _ => Err(anyhow!(
+                "Prebuilt remote servers are not yet available for {os:?}. See https://zed.dev/docs/remote-development"
+            ))?,
         };
         let arch = if arch.starts_with("arm") || arch.starts_with("aarch64") {
             "aarch64"
         } else if arch.starts_with("x86") || arch.starts_with("i686") {
             "x86_64"
         } else {
-            Err(anyhow!("unknown uname architecture {arch:?}"))?
+            Err(anyhow!(
+                "Prebuilt remote servers are not yet available for {arch:?}. See https://zed.dev/docs/remote-development"
+            ))?
         };
 
         Ok(SshPlatform { os, arch })