Skip to content

Installation

gsjonio edited this page Jul 13, 2026 · 3 revisions

Installation

netwp is a single self-contained binary. Requires Go 1.24+ to build from source; prebuilt binaries need nothing.

Prebuilt binary (no Go needed)

Download the Windows or Linux amd64 binary from the Releases page, put it on your PATH, and run netwp.

With the Go toolchain

go install github.com/gsjonio/netwp/cmd/netwp@latest
netwp

go install drops the binary in $(go env GOPATH)\bin; put that folder on your PATH. Pin a tag instead of @latest for a reproducible build, e.g. ...@v1.17.0.

Build from source

git clone https://github.com/gsjonio/netwp.git
cd netwp
go build -o netwp.exe ./cmd/netwp
go test ./...

Add -ldflags "-s -w" for a smaller binary (about 12 MB down to 8.8 MB).

Privileges

Command Windows Linux
scan · monitor · dashboard no privilege needs CAP_NET_RAW
everything else no privilege no privilege
iface static / iface dhcp elevated terminal not implemented

On Windows, scan uses the SendARP/IcmpSendEcho APIs, so the read-only commands never need admin and there is no Npcap to install. On Linux, grant the raw-ARP scanner its capability once instead of running as root:

sudo setcap cap_net_raw+ep $(which netwp)

Updating and removing

  • netwp update re-runs go install ...@latest (needs Go). Overwriting the running binary works even on Windows.
  • netwp uninstall removes netwp's local data after a confirmation and prints how to remove the binary.

Full platform notes are in the README.

Clone this wiki locally