Installation
These instructions target the public Go release v0.15.2. Start with an archive matching your operating system, architecture and native runtime; keep the archive's executable and libraries together.
Binary Distributions
Linux libc
Debian/Ubuntu-compatible runtime; retain net, lib/net.bin and bundled loader/libraries
Linux musl
Alpine-compatible runtime; use the musl archive rather than the libc archive
macOS DPI
macOS 26+; retain adjacent lib/ native libraries
macOS nodpi
macOS 15+; no native DPI classification
Windows
Match architecture; install compatible Npcap for live capture and BPF-dependent workflows
Linux wrappers load their private runtime; they do not install libraries into system directories. macOS libraries use executable-relative install names. Full supplier sources/build recipes accompany the macOS runtime asset.
net --version
net capture -hCheck that net --version resolves the intended executable and reports the expected commit/DPI status. A previously installed net elsewhere in PATH can hide the new archive. Continue with the synthetic first capture.
Homebrew
brew tap dreadl0ck/formulas
brew install netcap
net --versionThe formula installs its complete native runtime under libexec. The tap may advance beyond the release documented here; record the installed version when reproducing results.
Go Get
go get manages dependencies; it does not install current Go executables. Clone the release and build its embedded browser assets before compiling Go.
Manual Build
Install the Go version declared in go.mod, Node/pnpm for the UI, a C toolchain and libpcap headers. Native DPI and YARA require additional libraries; the following reduced build disables those two optional integrations:
This is a source build, not the packaged runtime distribution. nodpi does not remove libpcap requirements. Run it as ./net so an older executable in PATH cannot be selected accidentally.
Reproducible Builds via Go Modules
go.mod/go.sum pin module dependencies. Reproduction also requires a recorded source commit, Go/C toolchains, build tags, embedded UI and native libraries. Use GOWORK=off to avoid local workspace replacements. Dependency pinning alone does not prove bit-for-bit reproducibility.
Development Build
Follow macOS development for platform tooling and testing for scoped verification. Schema generation uses protoc-gen-gogofaster; it is unnecessary for an unchanged release checkout.
Cross Compilation
CGO and native dependencies mean GOOS/GOARCH alone are insufficient. Use the platform build recipes in zeus/scripts/ and supply the matching C compiler, headers and runtime. Verify the resulting archive on its target OS.
Buildsystem
Zeus drives builds/releases through zeus/commands.yml; the root Makefile provides test entrypoints. Run zeus without arguments to inspect available commands.
Optional enrichment
Signed clients verify publisher metadata. The default data directory is ~/.config/netcap/dbs; NC_CONFIG_ROOT changes its parent. Follow database updates for trust, source inventory and retired catalogues. Packet-only analysis can proceed without this optional enrichment.
Last updated