v2 / rebuilt from the socket up

Know every box
on your network.

reconYa sweeps your subnet, fingerprints what answers, and keeps a live map of it, so the thing that appeared on your LAN at 3am doesn't stay a mystery until morning.

Free for personal and homelab use. Businesses need a licence.

LinuxmacOSx86_64 / ARMself-hostedCC BY-NC 4.0
recon//unit-01 LIVE
iface eth0 arp · icmp · tcp pwr
01

What it does

Seven jobs, done properly. No agents to install on anything, no cloud account, no telemetry phoning home.

TCP

Port scanning

Sweeps the ports that matter and tells you what is actually listening, not what should be.

ICMP

Host discovery

Ping sweeps the range to find every box that is awake, including the ones nobody documented.

ARP

Passive monitoring

Watches ARP chatter between scans, so a device that joins quietly still gets caught.

ID

Device fingerprinting

Guesses the OS from how a host answers and resolves the MAC to a vendor. Printer or intruder: usually clear.

MAP

Live network map

The whole subnet as a grid. Occupied cells light up, gaps stay dark. Your LAN at a glance.

LOG

Event timeline

Every sweep, every appearance, every disappearance, timestamped, so you can answer "when did that show up?"

SEG

Multi-range networks

One network, several subnets. List the CIDR blocks you actually use and scan them on their own schedule, not a covering supernet nobody asked for.

02

How it works

Three moves from install to a live map.

01

Point it somewhere

Give it a subnet. It pre-fills the one you are on. No inventory file to write first.

target: 192.168.1.0/24
02

Let it sweep

Ping sweep, then port scans and fingerprinting on whatever answers. ARP watching runs alongside.

ping sweep → 44 hosts up
03

Watch it fill in

The map and device grid populate live while the event log narrates. Nothing to refresh.

live device [192.168.1.180] found
03

Install

Paste one line. Be scanning before the kettle boils.

$ curl -sL https://raw.githubusercontent.com/Dyneteq/reconya/master/install.sh | sh

Detects your OS and architecture, then drops the right build in place. Linux (x86_64, ARM64) and macOS (Intel, Apple Silicon).

dashboard → http://localhost:3008
login → admin / password (change it, obviously)
04

Licensing

If reconYa runs on a network someone is being paid to look after, that is a commercial licence. Everything else stays free.

Personal
Free forever

Homelab, flat, side project. Non-commercial use under CC BY-NC 4.0, with every feature and no device cap.

Full source, self-hosted
Community support on GitHub
No account, no telemetry
Install it now
For business
Commercial licence
$249 per year
per organisation

Covers every employee, every host and every subnet you run it on. Consultancies and MSPs included: scan your clients under the same licence.

Commercial and client work permitted
Unlimited seats, hosts and networks
Priority on bugs and issues
Invoice and VAT details on request
Site and multi-year terms available
Redistribution terms on request
05

Questions

Is it legal to scan?+

On networks you own or administer, yes. Pointed at someone else’s, scanning ranges from rude to prosecutable depending on where you live. Scan your own kit.

Why does it want root?+

ARP requests and ICMP echoes need raw sockets, and raw sockets need privileges. Nothing else in reconYa asks for them.

How is this different from nmap?+

nmap is a scalpel you run when you have a question. reconYa is the thing that keeps watching so you know a question exists: persistent inventory, a live map and a timeline, rather than one-shot output.

Does any data leave my network?+

No. It runs on your box, stores results on your box, and has nothing to phone home to. No accounts, no telemetry.

Can I run it in Docker?+

Not yet. Container support is being researched, but scanning from inside a container needs host networking to reach the LAN, and that is not fully solved. Run the binary on the host for now.

Which platforms are supported?+

Linux on x86_64 and ARM64, and macOS on both Intel and Apple Silicon. A Raspberry Pi is a perfectly good permanent home for it.

Can it watch more than one subnet?+

Two ways: define multiple target networks and scan them in turn, or give one network several CIDR ranges (two floors that don't share a supernet, say) and it sweeps each in turn and merges the results into one inventory. Either way, the host it runs on has to actually route to each range.

Is it really free?+

Yes, free, open-source, and non-commercially licensed. Sponsorship is welcome and buys nothing but faster fixes and more coffee.

Support reconYa

Free, open-source, and maintained on evenings and coffee. A star costs nothing; the rest keeps the coffee coming.