mirror of
https://github.com/EFForg/rayhunter.git
synced 2026-04-28 08:29:58 -07:00
3455adbf95
* client mode added
* Prevent OTA daemons dmclient and upgrade from running and phoning home to Verizon
* Fix workflow
* WIFI changes to support moxee. May need to rebase as delivering refactoring under other PR.
* code changes for rust based wifi client mode docs next
* Doc changes & security fixes
* Added watchdog and recover if crash occurs for wifi.
* Remove changes which were from device UI work (seperate feature which snuck into this branch)
* Add missing wifi and firewall module declarations
* cleaning up the code a bit
* Gate wpa_suplicant in installer and workflow to avoid building binary every push
* fix to check diskspace
* Improved support for subnet colisions, and attempts to rejoin network.
* Add WiFi client support and S01iptables to T-Mobile and Wingtech installers
Both installers now deploy wpa_supplicant, wpa_cli, udhcpc-hook.sh, and
the S01iptables boot-time firewall script. Config generation uses the
shared install_config/install_wifi_creds helpers instead of manual string
replacement.
* Revert "Add WiFi client support and S01iptables to T-Mobile and Wingtech installers"
This reverts commit 944b369c4f.
* Fix build: ignore unused wifi_ssid/wifi_password fields in T-Mobile and Wingtech installers
* Moved to a wifi crate
* Add host route and arp_filter to prevent subnet collisions
* add wakelock so kernel doesn't shut down wifi on battery when wifi is enabled
* Move wifi to external wifi-station crate, remove wifi from installer, extract OTA blocking
* fixed outdated info, moved udhcpc hook to wifi-station crate.
* Update to new version of wifi-station
* Address PR review feedback: replace Docker wpa build, add iw, remove OTA, revert unrelated changes
- Replace Docker-based wpa_supplicant build with shell script (scripts/build-wpa-supplicant.sh)
- Add iw cross-compilation and deployment to Orbic installer
- Skip wifi tool install if binary already exists on device
- Remove OTA daemon blocker (extracted for separate PR)
- Revert unrelated UZ801 and T-Mobile installer changes
- Remove connection.rs test scaffolding
- Rewrite S01iptables init script to read config.toml directly
- Pin url crate to 2.5.4 to fix MSRV
* Fix build script: use bash for parameter substitution
The ${VAR//pattern/replacement} syntax is a bash extension that
doesn't work in dash (Ubuntu's /bin/sh).
* Fix iw build: export PKG_CONFIG_LIBDIR as env var
Passing PKG_CONFIG_LIBDIR as a make variable doesn't export it to
$(shell pkg-config ...) calls. Set it as an environment variable
so pkg-config finds the cross-compiled libnl.
* Point wifi-station to GitHub rev 97c579a
* add comment
* Update daemon/src/config.rs
Add decorators
Co-authored-by: Andrej Walilko <walilkoa@gmail.com>
* Update daemon/src/server.rs
add utopia doc support
Co-authored-by: Andrej Walilko <walilkoa@gmail.com>
* Update daemon/src/server.rs
add utopia doc support
Co-authored-by: Andrej Walilko <walilkoa@gmail.com>
* Update to wifi-station with utoipa doc strings
* add utoipa to wifi-station
* added WPA3 support
* fix firewall port detection, update wifi-station to c267d37
fix ntfy port_or_known_default, comment out ntfy_url in config
template, update wifi-station with resolv.conf bind mount
fallback, udhcpc_bin config, and module path fix for UZ801
* show wifi UI for tmobile and wingtech, add udhcpc_bin config
both devices have wifi hardware and backend support. wingtech
verified on hardware (QCA6174 via PCIe). uz801 excluded for now
due to driver scan limitations with hostapd active.
* install wifi tools from orbic-usb installer, fix DNS default to Quad9, bump wifi-station rev
* fix Modal scroll listener leak, correct file transfer timeout math, document firewall fail-open, clarify UZ801 wifi status
* build-dev.sh: build wifi tools so install-dev works for orbic-family devices
* update Cargo.lock for wifi-station e8ec5b4
* fix setup_timeout_server crypto provider install, apply rustfmt
* Update installer/src/connection.rs
Co-authored-by: Cooper Quintin <cooperq@users.noreply.github.com>
* Update installer/src/orbic.rs
Co-authored-by: Cooper Quintin <cooperq@users.noreply.github.com>
* apply rustfmt to AdbConnection::run_command
---------
Co-authored-by: Andrej Walilko <walilkoa@gmail.com>
Co-authored-by: Cooper Quintin <cooperq@users.noreply.github.com>
85 lines
4.3 KiB
Markdown
85 lines
4.3 KiB
Markdown
# Installing from the latest release
|
|
|
|
Make sure you've got one of Rayhunter's [supported devices](./supported-devices.md). These instructions have only been tested on macOS and Ubuntu 24.04. If they fail, you will need to [install Rayhunter from source](./installing-from-source.md).
|
|
|
|
1. **For the TP-Link only,** insert a FAT-formatted SD card. This will be used to store all recordings.
|
|
2. Download the latest `rayhunter-vX.X.X-PLATFORM.zip` from the [Rayhunter releases page](https://github.com/EFForg/rayhunter/releases) for your platform:
|
|
- for Linux on x64 architecture: `linux-x64`
|
|
- for Linux on ARM64 architecture: `linux-aarch64`
|
|
- for Linux on armv7/v8 (32-bit) architecture: `linux-armv7`
|
|
- for MacOS on Intel (old macbooks) architecture: `macos-intel`
|
|
- for MacOS on ARM (M1/M2 etc.) architecture: `macos-arm`
|
|
- for Windows: `windows-x86_64`
|
|
|
|
3. Decompress the `rayhunter-vX.X.X-PLATFORM.zip` archive. Open the terminal and navigate to the folder. (Be sure to replace X.X.X with the correct version number!)
|
|
|
|
```bash
|
|
unzip ~/Downloads/rayhunter-vX.X.X-PLATFORM.zip
|
|
cd ~/Downloads/rayhunter-vX.X.X-PLATFORM
|
|
```
|
|
|
|
On Windows you can decompress using the file browser, then navigate to the
|
|
folder that contains `installer.exe`, **hold Shift**, Right-Click inside the
|
|
folder, then click "Open in PowerShell".
|
|
|
|
4. **Connect to your device.**
|
|
|
|
First turn on your device by holding the power button on the front.
|
|
|
|
Then connect to the device using either WiFi or USB tethering.
|
|
|
|
You know you are in the right network when you can access
|
|
<http://192.168.1.1> (Orbic) or <http://192.168.0.1> (TP-Link) and see the
|
|
hardware's own admin menu.
|
|
|
|
5. **On MacOS only**, you have to run `xattr -d
|
|
com.apple.quarantine installer` to allow execution of
|
|
the binary.
|
|
|
|
6. **Run the installer.**
|
|
|
|
```bash
|
|
# For Orbic:
|
|
./installer orbic --admin-password 'mypassword'
|
|
# Note: the arguments --admin-username 'myusername' and --admin-ip 'mydeviceip'
|
|
# may be required if different from the default.
|
|
|
|
# Optionally configure WiFi client mode during install (Orbic and Moxee only):
|
|
./installer orbic --admin-password 'mypassword' --wifi-ssid 'MyNetwork' --wifi-password 'networkpass'
|
|
|
|
# Or install over USB if you want ADB and a root shell (not recommended for most users)
|
|
./installer orbic-usb
|
|
|
|
# For TP-Link:
|
|
./installer tplink
|
|
```
|
|
|
|
* On Verizon Orbic, the password is the one used to login to the device's admin menu, and the default is the WiFi password.
|
|
* ***Note:*** If you have changed the device username, password, or IP address from their default values, these must be provided as arguments to the installer command above.
|
|
* On Kajeet/Smartspot devices, the default password is `$m@rt$p0tc0nf!g`
|
|
* On Moxee-brand devices, check under the battery for the password.
|
|
* You can reset the password by pressing the button under the back case until the unit restarts.
|
|
|
|
TP-Link does not require an `--admin-password` parameter.
|
|
|
|
For other devices, check `./installer --help` or the
|
|
respective page in the sidebar under "Supported
|
|
Devices."
|
|
|
|
7. The installer will eventually tell you it's done, and the device will reboot.
|
|
|
|
8. Rayhunter should now be running! You can verify this by [viewing Rayhunter's web UI](./using-rayhunter.md). You should also see a green line flash along the top of top the display on the device.
|
|
|
|
## Troubleshooting
|
|
|
|
* If you are having trouble installing Rayhunter and you're connecting to your device over USB, try using a different USB cable to connect the device to your computer. If you are using a USB hub, try using a different one or directly connecting the device to a USB port on your computer. A faulty USB connection can cause the Rayhunter installer to fail.
|
|
|
|
* You can test your device by enabling the test heuristic. This will be very noisy and fire an alert every time you see a new tower. Be sure to turn it off when you are done testing.
|
|
|
|
* On MacOS if you encounter an error that says "No Orbic device found," it may because you have the "Allow accessories to connect" security setting set to "Ask for approval." You may need to temporarily change it to "Always" for the script to run. Make sure to change it back to a more secure setting when you're done.
|
|
|
|
```bash
|
|
./installer --help
|
|
./installer util --help
|
|
```
|