mrkeyoor.com_
Sat 15 Aug 16:47 UTC
Self-Hostedevaluationupdated 15 Aug 2026

rayhunter

Rayhunter turns a supported mobile hotspot into a portable detector for suspicious cellular behavior associated with IMSI catchers, also called cell-site simulators. It records cellular control traffic, analyzes it on the device, and warns when its heuristics see patterns such as an unusual identity request, a 2G downgrade, or a null cipher.

Verdict

Rayhunter is the best-packaged open project for putting cellular-surveillance research into ordinary people's hands, provided you treat alerts as leads rather than proof. Its supported-device guidance, installers, live indicator, capture export, and detailed heuristic explanations make serious field use plausible. Buy the recommended regional hardware and use a current release; choose a raw capture or SDR tool only if you need deeper protocol control than Rayhunter's guided workflow provides.

Setup3/5Guided installer, but hardware, bands, SIM, and networking matter
Docs5/5Excellent device, install, heuristic, use, and recovery guidance
Community5/5Current releases and fast issue and pull-request activity
Maturity4/5Field-ready core with evolving heuristics and device-specific bugs

Who it’s for

Journalists, activists, researchers, and civil-society groups studying cellular surveillance in the field.
Security practitioners who can preserve and interpret PCAP or QMDL captures after an alert.
People willing to buy a specifically supported hotspot and verify its frequency bands for their region.
Community researchers who want to improve detection heuristics with real cellular control-plane data.

Who it’s NOT for

Anyone expecting an app that directly protects their everyday phone: Rayhunter runs on separate supported hotspot hardware and warns about suspicious events rather than blocking them.
Buyers who cannot source a region-compatible recommended device: the documentation recommends the Orbic RC400L for the Americas and TP-Link M7350 for Africa, Europe, and the Middle East.
Users who need a red warning to serve as conclusive proof: heuristics can produce false positives, and reanalysis can turn old red recordings green or old green recordings suspicious.
People unable to secure sensitive evidence: exported captures may include an IMSI and nearby tower identifiers that can reveal location, while the local web interface still uses HTTP.
Users outside the United States who cannot assess local law: EFF's disclaimer explicitly recommends consulting a lawyer about the legal risk.

Setup reality

The release installer is approachable for a hardware security project, but it is not software-only. First buy a supported hotspot with the right regional bands and obtain a SIM; TP-Link users also need a FAT-formatted SD card. Then download the correct installer archive, connect to the hotspot over Wi-Fi or USB, run a device-specific terminal command, and let it reboot. Current release packages cover Windows, macOS, and several Linux architectures, although the written release path says it has been tested only on macOS and Ubuntu 24.04. Building from source adds Rust, Node.js, a C toolchain, device-specific access, and a real risk of recovery work if low-level steps go wrong.

A practical detector, not a magic shield

Rayhunter addresses a hard security problem with a surprisingly understandable product. Cell-site simulators impersonate legitimate cellular towers, causing nearby devices to reveal identifiers or accept weaker connection conditions. Detecting that behavior has traditionally required a rooted phone or an expensive software-defined radio setup. Rayhunter instead installs on certain inexpensive mobile hotspots and watches the control traffic between the modem and the network.

The distinction between control traffic and user traffic matters. Rayhunter is not reading web requests or message contents. It records signaling data, analyzes it on the hotspot, and changes a visible line from green to yellow, orange, or red when a heuristic fires. A local web interface lets the user stop or start recordings, inspect warnings, and download captures for deeper review.

That is useful, but it is detection rather than protection. Rayhunter does not prevent a phone from connecting to a suspicious tower, and an alert is not a verdict. EFF's FAQ says there is no universal response because the circumstances vary. Depending on the threat, turning off nearby phones and leaving the area may be appropriate, but the software cannot make that decision for you.

The heuristics are thoughtful and explainable

Rayhunter's strongest technical choice is to look for sequences and conditions rather than treating every identity request as hostile. A normal network may ask for an IMSI or IMEI during initial attachment, roaming, a temporary-identifier failure, or a core-network restart. The IMSI Requested analyzer becomes suspicious when an identity request appears in a sequence without expected authentication, after authentication, or without the device first connecting to the tower. The documentation acknowledges a false-positive case around aircraft reconnecting near landing.

Other analyzers look for a forced redirect toward 2G, LTE broadcasts that prioritize older networks, incomplete system-information chains, and requests for null encryption at the radio or NAS layer. Each explanation includes the legitimate network behavior, the suspicious variation, and known ambiguity. Users can disable noisy or experimental heuristics because behavior differs across countries and carriers. A deliberately loud test analyzer fires when a new tower appears, providing a reasonable installation check without asking users to build an illegal test transmitter.

The analysis can improve after data is collected. Old captures may be reanalyzed on the device or with the bundled rayhunter-check desktop tool. That feature is valuable for research, but it also proves why a colored line should not be treated as permanent truth: refined heuristics can turn a former warning green or flag a recording that was previously clear. Preserve the software version and raw capture alongside any finding.

Hardware selection is part of setup

The project now documents eight functional device families, but only two sit in the recommended tier. The Orbic RC400L is the preferred choice for the Americas; the TP-Link M7350 is recommended for Africa, Europe, and the Middle East. Buyers must compare a device's supported frequencies with local networks. A cheap hotspot from the wrong region can install correctly and still be a poor sensor.

Installation from a release is manageable. Download the archive for the host computer, connect to the hotspot, run an installer command for that model, and wait for a reboot. Orbic installation may require its admin credentials. TP-Link needs a FAT-formatted SD card for recordings. Release assets cover Windows, Intel and Arm macOS, x64 and Arm Linux, but the guide says the documented flow has only been tested on macOS and Ubuntu 24.04. An open August report also says TP-Link hardware version 10 may hang during installation because expected networking settings are absent. Exact hardware revisions still matter.

Source builds are a different tier of work. They combine a Rust daemon and installer with a SvelteKit interface, plus Node.js and C build tools. Device access varies across trimmed Android systems and modem interfaces. The source guide warns that people have bricked Orbic units while using ADB on Windows. Most users should take that as a firm reason to use a published release and a recommended device.

Treat captures and the interface as sensitive

Rayhunter's web dashboard is served over HTTP. The docs tell users to click through the browser's insecure-connection and blocked-download warnings. That is tolerable on a dedicated hotspot network under your control, but enabling Wi-Fi client mode makes the dashboard reachable from another local network. Operators should decide who can join that network and avoid exposing port 8080 beyond it.

The recordings deserve stricter handling. EFF warns that a capture may contain the SIM's IMSI and unique identifiers for nearby towers, which can help reconstruct where the device was. Optional GPS collection can add exact location history, and WebDAV upload can move closed QMDL and analysis files to another server. Those features are excellent for field teams, but only when retention, access, transport, and deletion policies are decided before collection.

Healthy enough for field use, still research software

The repository was pushed on August 14, 2026, one day before this review, and release v0.12.0 arrived on August 3. That release added compressed capture support, serving-cell and neighbor-cell measurements, JSON output for the checker, a roaming false-positive fix, and dependency updates. GitHub reported 94 open issues and PRs, with same-day discussion and contributions around SIM health, clock drift, and analyzer behavior. This is active maintenance, not a dormant security demo.

Open reports still cover real operational problems: false alerts around suspicious identity requests, a TP-Link installation revision, PinePhone installation failures, and malformed capture handling in the desktop checker. The right conclusion is not that Rayhunter is unreliable. It is that cellular networks and inexpensive modem hardware create messy evidence.

For field research, Rayhunter combines the right things: affordable hardware, transparent detection logic, a simple physical indicator, raw evidence export, and unusually good documentation. Use the recommended hardware, keep it updated, protect the captures, and have an expert review serious alerts. Under those conditions, it turns a specialist investigation into something a small organization can genuinely operate.

Alternatives

ProjectWhat it isPick it when
QCSuperA Qualcomm diagnostic tool for capturing raw 2G, 3G, and 4G radio frames from phones and modems.pick this instead when you want lower-level capture access and will perform the cellular analysis yourself.
Android IMSI-Catcher DetectorAn Android-focused project for identifying suspicious mobile-network behavior from a handset.pick this instead when the experiment must live on an Android phone and you accept its different hardware and maintenance constraints.
gr-gsmGNU Radio blocks and command-line tools for receiving and inspecting GSM transmissions with an SDR.pick this instead when you need direct 2G radio analysis and already have software-defined radio expertise.

What people are saying

  1. [github-trending] EFForg/rayhunter

Sources

  1. Rayhunter repository
  2. Rayhunter Book
  3. Supported devices
  4. Installing Rayhunter from a release
  5. Rayhunter heuristics
  6. Rayhunter FAQ
  7. Rayhunter v0.12.0 release
  8. TP-Link v10 installation report