mirror of
https://github.com/EFForg/rayhunter.git
synced 2026-04-26 07:29:59 -07:00
Due to recent build changes, --release no longer applies the right optimization settings, and --profile firmware has to be used.
3.1 KiB
3.1 KiB
Installing from source
Building Rayhunter from source, either for development or because the install script doesn't work on your system, involves a number of external dependencies. Unless you need to do this, we recommend you use our compiled builds.
- Install nodejs/npm, which is required to build Rayhunter's web UI
- Make sure to build the site with
cd bin/web && npm install && npm run buildbefore building Rayhunter. If you're working directly on the frontend,npm run devwill allow you to test a local frontend with hot-reloading (usehttp://localhost:5173instead ofhttp://localhost:8080).
- Make sure to build the site with
- Install ADB on your computer using the instructions above, and make sure it's in your terminal's PATH
- Install
curlon your computer to run the install scripts. It is not needed to build binaries.
Install Rust targets
Install Rust the usual way. Then,
- install the cross-compilation target for the device rayhunter will run on:
rustup target add armv7-unknown-linux-musleabihf
- install the statically compiled target for your host machine to build the binary installer
serial.
# check which toolchain you have installed by default with
rustup show
# now install the correct variant for your host platform, one of:
rustup target add x86_64-unknown-linux-musl
rustup target add aarch64-unknown-linux-musl
rustup target add aarch64-apple-darwin
rustup target add x86_64-apple-darwin
rustup target add x86_64-pc-windows-gnu
Now you can root your device and install Rayhunter by running:
cargo build --bin rayhunter-daemon --target armv7-unknown-linux-musleabihf --profile firmware --no-default-features --features orbic
cargo build --bin rootshell --target armv7-unknown-linux-musleabihf --profile firmware
cargo run --bin installer orbic
If you're on Windows or can't run the install scripts
- Root your device on Windows using the instructions here: https://xdaforums.com/t/resetting-verizon-orbic-speed-rc400l-firmware-flash-kajeet.4334899/#post-87855183
- Build the web UI using
cd bin/web && npm install && npm run build - Push the scripts in
scripts/to/etc/init.don device and make a directory called/data/rayhunterusingadb shell(and sshell for your root shell if you followed the steps above) - You also need to copy
config.toml.exampleto/data/rayhunter/config.toml - Then run
./make.sh, which will build the binary, push it over adb, and restart the device. Once it's restarted, Rayhunter should be running!