For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

Distribution
Runtime requirement

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 -h

Check 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 --version

The 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