gitwtfhub

wtf is reconya?

dyneteq/reconya — explained in plain English

Analysis updated 2026-08-13

1,684GoAudience · ops devopsComplexity · 3/5Setup · moderate

TL;DR

reconYa is a Go-based tool that scans and monitors your local network in a web dashboard, discovering devices, open ports, and alerting on changes.

Mindmap

mindmap
  root((reconYa))
    What it does
      Network device discovery
      Port scanning
      Live alerting
    Tech stack
      Go
      SQLite
      Web console
    Use cases
      Home network monitoring
      Security auditing
      Multi network management
    Audience
      Network admins
      Security professionals
    Privacy
      Zero outbound by default
      Opt in lookups

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Discover every device currently connected to your home or office network

REASON 2

Monitor a network continuously and get alerted when a new or risky device appears

REASON 3

Scan open ports and identify running services on local devices

REASON 4

Manage and scan multiple separate networks from one dashboard

What's in the stack?

GoSQLiteJavaScript

How it stacks up

dyneteq/reconyatylertreat/boomfiltersstupside/castor
Stars1,6841,6461,743
LanguageGoGoGo
Last pushed2025-11-17
MaintenanceQuiet
Setup difficultymoderateeasymoderate
Complexity3/53/53/5
Audienceops devopsdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Needs elevated privileges (sudo) to scan the network and Go 1.25+ if building from source.

Wtf does this do

reconYa is a network scanning tool built in Go that discovers and keeps track of every device connected to your local network, showing everything in a web dashboard you can open in your browser. It is meant for network administrators, security professionals, and curious home users who want to know exactly what is talking on their network. Once running, reconYa continuously sweeps your network using ICMP pings, TCP connection probes, and ARP lookups to find active devices, then identifies each one by its MAC address, manufacturer, hostname, and operating system where possible. It also scans the most common ports on each device to see what services are running and grabs banners for extra detail. Alongside the usual IPv4 scanning, it can passively watch IPv6 traffic without sending any packets of its own, simply by observing network discovery messages and interface activity. The web console shows all of this as a live topology map, a list of hosts, and an event log, and it raises alerts you can acknowledge whenever something notable happens, such as a new device joining, a risky open port appearing, a device going unreachable, or a duplicate MAC address turning up. You can manage several separate networks at once, each defined by its own address range, and switch them on or off without losing their scan history. By default reconYa makes no connections to the outside internet at all, everything runs off data it gathers from your own local network. A handful of optional features, like looking up your public IP address, resolving it to a rough location, or checking an online database for unrecognized device manufacturers, are all switched off until you explicitly enable them in the configuration file. You can install reconYa with a one-line script that downloads a pre-built binary for Linux or macOS, or build it from source using Go and a bundled make command that handles dependencies and starts it as a background service. After starting it, you open a local web address and log in with a default username and password that you are expected to change.

Yoink these prompts

Prompt 1
Walk me through installing reconYa with the quick install script on Linux or macOS
Prompt 2
Help me configure reconYa's .env file to change the default admin password
Prompt 3
Explain what data reconYa sends outside my network by default and how to keep it fully offline
Prompt 4
How does reconYa's IPv6 passive monitoring work without generating any traffic?
Prompt 5
Why is Docker not recommended for running reconYa, and what should I use instead?

Frequently asked questions

wtf is reconya?

reconYa is a Go-based tool that scans and monitors your local network in a web dashboard, discovering devices, open ports, and alerting on changes.

What language is reconya written in?

Mainly Go. The stack also includes Go, SQLite, JavaScript.

How hard is reconya to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is reconya for?

Mainly ops devops.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.