diff --git a/README.md b/README.md
index 832bbd5a..71b5795d 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,14 @@ OpenJarvis is that stack. It is a framework for local-first personal AI, built a
 curl -fsSL https://openjarvis.ai/install.sh | bash
 ```
 
+> **If you see `sslv3 alert handshake failure` on `openjarvis.ai`** ([issue #337](https://github.com/open-jarvis/OpenJarvis/issues/337)), use the GitHub mirror until the domain is restored:
+>
+> ```bash
+> curl -fsSL https://raw.githubusercontent.com/open-jarvis/OpenJarvis/main/scripts/install/install.sh | bash
+> ```
+>
+> Same script, served straight from this repo. The installer itself fetches everything else (uv, the project source, Ollama) from independent CDNs, so the rest of install proceeds normally.
+
 That's it. The installer handles everything: uv, the Python venv, Ollama, and pulling a small starter model. About 3 minutes on a typical broadband connection. Then:
 
 ```bash
diff --git a/docs/getting-started/install.md b/docs/getting-started/install.md
index cf4082df..df3862d9 100644
--- a/docs/getting-started/install.md
+++ b/docs/getting-started/install.md
@@ -6,6 +6,18 @@ OpenJarvis ships a one-line installer for macOS, Linux, and WSL2.
 curl -fsSL https://openjarvis.ai/install.sh | bash
 ```
 
+!!! warning "`openjarvis.ai` SSL fallback (issue #337)"
+    If `curl` fails on `openjarvis.ai` with `sslv3 alert handshake failure`,
+    fetch the same script from the GitHub mirror until the domain is restored:
+
+    ```bash
+    curl -fsSL https://raw.githubusercontent.com/open-jarvis/OpenJarvis/main/scripts/install/install.sh | bash
+    ```
+
+    The installer itself pulls everything else (uv, the project source,
+    Ollama) from independent CDNs (`astral.sh`, `github.com`,
+    `ollama.com`), so the rest of install proceeds normally.
+
 About 3 minutes on a typical broadband connection. Type `jarvis` to start chatting.
 
 ## What the installer does