Markus Unterwaditzer 3e38f500a9 Install to /cache/rayhunter-data for tplink, add --data-dir parameter
This fixes several space-related issues at once.

We have observed the following phenomenon on TP-Link, Orbic and Moxee:

- Filling /data bricks the device (broken wifi, broken rndis, broken
  display)

- Filling /cache does not (it only bricks rayhunter if it's installed
  there, and it might break firmware updates)

Therefore it would make sense to store the entire rayhunter installation
in /cache.

This is a great idea for TP-Link and Moxee, because /cache is
significantly larger than /data. However, on Orbic, /data is
significantly larger than /cache!

This PR refactors orbic-network and tplink to use a shared codepath for
setting up the data directory. A symlink is created at /data/rayhunter,
and what it points to is device-specific:

- Orbic will have its data at `/data/rayhunter-data`

- There is a new alias `installer moxee` that overrides this to
  `/cache/rayhunter-data`

- TP-Link will have its data at /cache/rayhunter-data when there's no SD
  card, and /media/whatever when there is one.

In all cases, existing data is migrated to the new location. The user
can switch back and forth between two values of --data-dir and the data
will be moved over every time.

This PR has one huge wart, and that is that the USB installer for Orbic
remains untouched. The annoying reason for this is that the
DeviceConnection trait is insufficient to reflect all the different
kinds of shells you can have over USB: adb with fakeroot, and serial
with real root. I think it's not possible to create the right
directories with 'rootshell -c'.

I'm thinking of spawning a telnet server over serial, so that we can
just do telnet again, but this is for another time.
2026-02-24 13:42:31 -08:00
2026-02-17 01:41:15 +01:00
2026-02-05 12:27:09 -08:00
2026-02-17 18:55:34 +01:00
2026-02-17 01:41:15 +01:00
2025-11-17 12:09:25 -08:00
2026-02-05 12:27:09 -08:00
2026-02-05 12:27:09 -08:00
2025-07-16 13:20:14 -07:00
2025-11-18 21:05:22 +01:00
2026-02-17 01:41:15 +01:00
2025-03-07 11:40:37 -08:00
2023-11-08 15:23:19 -08:00
2025-12-03 09:56:25 -08:00
2025-03-11 15:35:47 -07:00

Rayhunter

Tests

Rayhunter Logo - An Orca taking a bite out of a cellular signal bar

Rayhunter is a project for detecting IMSI catchers, also known as cell-site simulators or stingrays. It was first designed to run on a cheap mobile hotspot called the Orbic RC400L, but thanks to community efforts, it can support some other devices as well. It's also designed to be as easy to install and use as possible, regardless of your level of technical skills, and to minimize false positives.

→ Check out the installation guide to get started.

→ To learn more about the aim of the project, and about IMSI catchers in general, please check out our introductory blog post.

→ For discussion, help, or to join the mattermost channel and get involved with the project and community check out the many ways listed here!

→ To learn more about the project in general check out the Rayhunter Book.

LEGAL DISCLAIMER: Use this program at your own risk. We believe running this program does not currently violate any laws or regulations in the United States. However, we are not responsible for civil or criminal liability resulting from the use of this software. If you are located outside of the US please consult with an attorney in your country to help you assess the legal risks of running this program.

Good Hunting!

Description
No description provided
Readme GPL-3.0 17 MiB
Languages
Rust 76.9%
Svelte 16%
TypeScript 3.7%
Shell 1.2%
Python 1.2%
Other 0.9%