From c5a79e545d08c02b43f4c73220d5097315a5709f Mon Sep 17 00:00:00 2001 From: Markus Unterwaditzer Date: Wed, 20 Aug 2025 15:26:48 +0200 Subject: [PATCH] Add documentation for Orbic Network installer --- doc/installing-from-release-windows.md | 6 ++++++ doc/orbic.md | 17 +++++++++++++++++ 2 files changed, 23 insertions(+) diff --git a/doc/installing-from-release-windows.md b/doc/installing-from-release-windows.md index a17bbdc..bfedbe7 100644 --- a/doc/installing-from-release-windows.md +++ b/doc/installing-from-release-windows.md @@ -11,6 +11,12 @@ Windows support in Rayhunter's installer is a work-in-progress. Depending on the ## Orbic +
+ +[The Windows installer is known to be buggy](https://github.com/EFForg/rayhunter/issues/366). Consider using the [Network-based installer](./orbic.md#the-network-installer). + +
+ 1. Connect the device to your computer using the provided USB cable. 1. Install the [Zadig WinUSB driver installer](https://zadig.akeo.ie/). 1. Open Zadig, click options->show all devices diff --git a/doc/orbic.md b/doc/orbic.md index 905eba7..fbdd1a7 100644 --- a/doc/orbic.md +++ b/doc/orbic.md @@ -19,8 +19,25 @@ or on [eBay](https://www.ebay.com/sch/i.html?_nkw=orbic+rc400l). | Wifi 5Ghz | a/ac/ax | | Wifi 6 | 🮱 | +## The Network Installer + +Since Rayhunter 0.6.0 there is an alternative, experimental installation +procedure at `./installer orbic-network` that is supposed to eventually replace +`./installer orbic`. It does not require any USB driver installation and works +identically on Windows, Mac and Linux. From our testing it works much more +reliably on Windows than `./installer orbic` does. + +The drawback is that the device's admin password is required. If you have a Kajeet-branded "SmartSpot" you currently have to use the USB-based `./installer orbic`, as we currently don't know of a way to get that admin password. + +1. Connect to the Orbic's network via WiFi or USB tethering +2. Run `./installer orbic-network` +3. The installer will ask you to log into the admin UI on `localhost:4000`. The password for that is the same as the WiFi password. +4. As soon as you're logged in, the installer will continue and reboot the device. + ## Obtaining a shell After running through the installation procedure, you can obtain a root shell by running `adb shell` or `./installer util shell`. Then, inside of that shell you can run `/bin/rootshell` to obtain "fakeroot." + +If you are using the network installer, there will not be a rootshell and ADB will not be enabled by the installer. Instead you can use `./installer util orbic-start-telnet` and connect to the hotspot using `nc 192.168.1.1 23`. On Windows you might not have `nc` and will have to use WSL for that.