From 3aac7e0e136ab6ec12f75e5d361dc956de8e9526 Mon Sep 17 00:00:00 2001
From: fourbroad <zhusihong@ins24.com>
Date: Thu, 30 Jul 2026 11:14:56 +0800
Subject: [PATCH] docs: add manual install fallback for networks where the
 one-liner fails

---
 README.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/README.md b/README.md
index ddb312a..1234580 100644
--- a/README.md
+++ b/README.md
@@ -17,6 +17,38 @@ curl -fsSL https://eightarms.net/fourbroad/octopus-release/raw/branch/main/insta
 irm https://eightarms.net/fourbroad/octopus-release/raw/branch/main/install.ps1 | iex
 ```
 
+### Manual install
+
+If the one-liner fails with a connection error, the direct connection to `eightarms.net` is likely being filtered on your network. Download the archive for your platform from the [releases page](https://eightarms.net/fourbroad/octopus-release/releases/latest) and install it manually instead.
+
+**Unix (Linux/macOS):**
+
+```bash
+# after downloading octopus-<platform>.tar.gz from the releases page
+tar -xzf octopus-linux-x64.tar.gz
+sudo mv octopus /usr/local/bin/
+octopus --version
+```
+
+**Windows (PowerShell):**
+
+After downloading `octopus-windows-x64.zip` from the releases page:
+
+```powershell
+$zip = "$env:USERPROFILE\Downloads\octopus-windows-x64.zip"
+$dest = "$env:USERPROFILE\.octopus\bin"
+$tmp  = Join-Path $env:TEMP "octopus_manual"
+New-Item -ItemType Directory -Force -Path $dest,$tmp | Out-Null
+Expand-Archive -Path $zip -DestinationPath $tmp -Force
+Copy-Item "$tmp\octopus.exe" "$dest\octopus.exe" -Force
+Remove-Item -Recurse -Force $tmp
+$p = [Environment]::GetEnvironmentVariable('Path','User')
+if ($p -notlike "*$dest*") { [Environment]::SetEnvironmentVariable('Path', ($p.TrimEnd(';') + ";$dest"), 'User') }
+& "$dest\octopus.exe" --version
+```
+
+Open a **new** terminal and run `octopus`.
+
 ## Documentation
 
 Visit the [documentation](https://eightarms.net/fourbroad/octopus/wiki) for usage guides and API reference.