docs(install): add GitHub-raw fallback for the openjarvis.ai install URL

Addresses #337 (also reported as #352).

`curl -fsSL https://openjarvis.ai/install.sh | bash` — the documented
one-liner — currently fails with:

    curl: (35) ... sslv3 alert handshake failure

Reproduced from this machine just now; @kumanday and @filactre both
report the same against different OpenSSL and LibreSSL versions. The
underlying SSL issue is on the openjarvis.ai server (cert / TLS
config) and needs an operational fix at the infra layer — not
something a code change in this repo can resolve.

What this commit *can* do is unblock users immediately:

- `README.md` (under "Installation"): callout pointing at issue #337
  and the GitHub-mirror fallback.
- `docs/getting-started/install.md`: same callout as a
  Material-for-MkDocs `!!! warning` admonition.

Both link to the canonical script at
`https://raw.githubusercontent.com/open-jarvis/OpenJarvis/main/scripts/install/install.sh`.
The script is identical content — it's the same `scripts/install/install.sh`
served from GitHub's CDN instead of openjarvis.ai. Once the
installer runs, it pulls everything else (`uv` from astral.sh, the
project source from `github.com/open-jarvis/OpenJarvis.git`, Ollama
from `ollama.com`) — none of which depend on `openjarvis.ai`. So
the rest of install proceeds normally.

When the openjarvis.ai SSL issue is fixed at the server / DNS layer,
both callouts can be removed and the canonical URL becomes the only
documented path again.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
krypticmouse
2026-05-23 15:25:08 +00:00
co-authored by Claude Opus 4.7
parent 0483f5377d
commit 52e830e1a4
2 changed files with 20 additions and 0 deletions
+8
View File
@@ -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
+12
View File
@@ -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