Troubleshooting

Troubleshooting

netwp is not found after go install

The binary is in $(go env GOPATH)\bin (often %USERPROFILE%\go\bin on Windows, ~/go/bin on Linux). Add that folder to your PATH, or run it with the full path once to confirm it built.

Linux: scan finds nothing / "operation not permitted"

The raw-ARP scanner needs the CAP_NET_RAW capability. Grant it once:

sudo setcap cap_net_raw+ep $(which netwp)

Then run netwp scan as your normal user. Running under sudo works too but is heavier-handed.

Linux: "too many open files" during a big scan

Each device is probed across many ports concurrently. On a large, busy subnet this can approach the file-descriptor limit (default 1024 on many distros). netwp caps the probe fan-out, but if you still hit it, raise the limit for the session:

ulimit -n 4096

Scan shows fewer devices than I expect

• A device that is asleep or does not answer ARP will not appear. Wake it (or wait for it to talk) and rescan.
• Some devices rate-limit or ignore probes. monitor catches them over time as they become active.
• You are only scanning the active interface's subnet. A device on a different VLAN or subnet is out of reach.

A device is misclassified (wrong CLASS)

Pin it: netwp class set <ip|mac> <router|computer|mobile|media|printer|iot>. The pin is kept by MAC and always overrides the guess. netwp class ls shows your pins; netwp class rm removes one.

The dashboard looks cramped or the footer is cut off

The dashboard needs a reasonably tall terminal (it stacks several panels). On a short window the LOG panel shrinks and then hides, and the device table truncates, so the footer stays visible. Make the terminal taller for the full view.

Colors or box-drawing look wrong

Use a terminal with UTF-8 and 256-color/ANSI support (Windows Terminal, most Linux terminals). The classic cmd.exe console renders the TUI poorly.

iface static / iface dhcp does nothing

They change the real network config, so they need an elevated terminal on Windows (Run as administrator) and always ask for a typed "yes". They are not implemented on Linux.

Wi-Fi panel is blank on the dashboard

netwp reads Wi-Fi state from netsh wlan (Windows). On a wired-only machine there is no Wi-Fi to show, which is expected. netwp doctor will report "not on Wi-Fi (wired connection)".

netwp update fails

update needs the Go toolchain on PATH (it wraps go install ...@latest). If you installed from a prebuilt binary and have no Go, download the new binary from the Releases page instead.

Still stuck? Open an issue with your OS, netwp version, and what you ran.