Setup
Dependencies
Ze uses 57 direct Go dependencies. The list and versions come from go.mod, and each entry explains how Ze uses that dependency, with references to the code that imports it.
Terminal, Web & SSH Interfaces 11
| Module | Version | Why we use it |
|---|---|---|
charm.land/bubbletea/v2 | v2.1.1 | The Elm-style TUI framework driving Ze's interactive CLI: config editor, dashboard, monitor, ping and traceroute views, run per SSH session. |
charm.land/bubbles/v2 | v2.2.1 | Pre-built TUI widgets (text input, viewport) for the CLI's interactive screens. |
charm.land/lipgloss/v2 | v2.0.6 | Styling and layout for the CLI's colors, borders, and widths. |
charm.land/wish/v2 | v2.0.5 | SSH server middleware that wires each incoming session to run the CLI's Bubbletea program. |
charm.land/ssh | v0.4.3 | SSH session and public-key types that the wish server and the CLI's key-based auth build on. |
github.com/a-h/templ | v0.3.1100 | Compiles the typed server-rendered components used by Ze's web configuration interface and BGP looking glass into Go. |
github.com/charmbracelet/colorprofile | v0.4.3 | Forces a deterministic color profile in render tests, so CLI screenshot/layout tests don't depend on the terminal running them. |
github.com/charmbracelet/x/ansi | v0.11.9 | Strips terminal escape codes in the CLI editor tests, so a pattern matches the text the operator sees rather than its color codes. |
github.com/muesli/reflow | v0.3.0 | ANSI-aware text width calculation, so the CLI's prompt and status bar line up correctly despite embedded color codes. |
github.com/creack/pty | v1.1.24 | Opens a pseudo-terminal in a Linux integration test that exercises serial console handling. |
github.com/chromedp/chromedp | v0.21.0 | Drives headless Chrome in a test that proves the website fills its published figures from the facts snapshot. |
Networking & Protocols 7
| Module | Version | Why we use it |
|---|---|---|
github.com/miekg/dns | v1.1.73 | DNS message parsing and serving underneath Ze's DNS server engine, the AS112 blackhole plugin, and GeoDNS. It's the library underpinning CoreDNS. |
github.com/insomniacslk/dhcp | v0.0.0-20261014062924-c6bb46ad3f3a | DHCPv4/DHCPv6 client used for interface lease handling and the installer's disk-provisioning DHCP client. |
github.com/beevik/ntp | v1.6.0 | NTP client queries used by the ntp plugin. |
golang.zx2c4.com/wireguard/wgctrl | v0.0.0-20241231184526-a9ab2273dd10 | Creates and configures WireGuard interfaces and peers from the interface netlink backend. |
github.com/mdlayher/packet | v1.2.0 | Raw AF_PACKET sockets behind the diag capture CLI command. |
github.com/packetcap/go-pcap | v0.0.0-20260731105150-c86974bbfbcd | Only its filter subpackage: parses tcpdump/BPF-style filter expressions for diag capture. Packet capture itself goes through mdlayher/packet instead. |
github.com/cloudflare/circl | v1.6.5 | Only its Ed448 package: Ed448 signatures for IKEv2 authentication (RFC 8420). |
Linux Kernel Interfaces 7
| Module | Version | Why we use it |
|---|---|---|
github.com/vishvananda/netlink | v1.3.1 | The main library for configuring the Linux network stack: links, addresses, routes, neighbors, bridges, VLANs, tunnels, IPsec, QoS. Used across interfaces, traffic, FIB, OSPF, ISIS, and MPLS. |
github.com/vishvananda/netns | v0.0.5 | Linux network-namespace handles, used alongside netlink for namespace-scoped route watching. |
github.com/google/nftables | v0.3.0 | Programs the kernel's nftables firewall (tables, chains, rules, sets) over netlink. |
github.com/mdlayher/netlink | v1.11.2 | Low-level generic netlink sockets, used to flush conntrack flow entries for flow export. |
github.com/mdlayher/genetlink | v1.4.0 | Generic netlink family dialing, used to attach to the kernel's psample subsystem for sampled flow export. |
github.com/cilium/ebpf | v0.22.0 | Assembles and attaches eBPF programs in pure Go, no clang or libbpf needed, to count traffic for the trafficusage plugin. |
filippo.io/mlockexe | v1.0.0 | Locks the running ze executable's own file-backed pages in memory with mlock2(2) and MLOCK_ONFAULT, so the kernel cannot evict the daemon's text under memory pressure. A router short of memory reclaims page cache, and the running daemon IS page cache: without the lock it waits on the disk holding its own binary at the moment it must keep sessions alive. |
Routing & Dataplane 2
| Module | Version | Why we use it |
|---|---|---|
github.com/gaissmai/bart | v0.30.0 | Balanced Routing Table, built on Knuth's Allotment Routing Table (ART): the longest-prefix-match structure underneath Ze's RIB store. |
go.fd.io/govpp | v0.13.0 | Binary-API client for FD.io VPP, used by the optional VPP dataplane backends for interfaces, firewall, traffic, FIB, and IKE. |
Config, RPC & Telemetry 5
| Module | Version | Why we use it |
|---|---|---|
github.com/openconfig/goyang | v1.6.4-0.20251113201521-a80f2799d7b9 | Parses and validates the YANG module definitions behind Ze's config schema, CLI completion, and validation engine. |
github.com/openconfig/gnmi | v0.14.1 | Generated gNMI protobuf/gRPC types that Ze's gNMI server implements for Get/Set/Subscribe/Capabilities. |
google.golang.org/grpc | v1.85.0 | Backs Ze's gRPC servers: gNMI and Ze's own management API. |
google.golang.org/protobuf | v1.36.12 | Runtime support for the generated protobuf message types behind Ze's gRPC API. |
google.golang.org/grpc/cmd/protoc-gen-go-grpc | v1.6.2 | Build-time only: the protoc plugin used to regenerate the gRPC API's Go bindings from ze.proto. |
Observability 5
| Module | Version | Why we use it |
|---|---|---|
github.com/prometheus/client_golang | v1.25.0 | Ze's internal metrics backend: counters, gauges, and histograms against a private registry. |
github.com/prometheus/client_model | v0.6.3 | The metric sample types the L2TP subscriber tests and the BGP interop lab read a gauge's current value through. |
github.com/prometheus/common | v0.73.1 | Reads the Prometheus text exposition format back: the IPsec interop test parses Ze's own metrics answer and compares the gauges against the kernel. |
github.com/prometheus/procfs | v0.23.0 | Parses Linux /proc for the telemetry collector: CPU, memory, network device and socket stats, conntrack, softnet. |
github.com/sirupsen/logrus | v1.10.2 | Only to satisfy GoVPP's logging interface, bridged into Ze's own slog logger via a hook. Not used as Ze's own logger. |
Standard Library Extensions (golang.org/x) 9
| Module | Version | Why we use it |
|---|---|---|
golang.org/x/crypto | v0.58.0 | SSH protocol primitives and certificate signing for the SSH server, plus password hashing. |
golang.org/x/mod | v0.42.0 | Parses and rewrites go.mod files when the appliance build prepares an isolated instance of the tree, so an image is never built from the tracked working copy. |
golang.org/x/net | v0.62.0 | Raw ICMP packet connections for the traceroute plugin, and hostname normalization for MCP's auth. |
golang.org/x/sync | v0.24.0 | errgroup, which the plugin manager uses to drain every plugin's event queue concurrently and return the first failure. |
golang.org/x/sys | v0.49.0 | Low-level Linux syscalls: disk sync and reboot in the installer, used throughout the Linux-specific components. |
golang.org/x/term | v0.47.0 | Reads passwords without echo and detects an interactive terminal during CLI login. |
golang.org/x/text | v0.43.0 | Prepares TACACS+ usernames with the PRECIS UsernameCasePreserved profile that RFC 8907 Section 3.7 requires. |
golang.org/x/tools | v0.52.0 | Build-time only: goimports, pinned via a tools.go tracking file, never compiled into Ze's binaries. |
golang.org/x/vuln | v1.9.0 | Build-time only: govulncheck, pinned through the tools.go tracking file, which reports known vulnerabilities in the modules Ze vendors. |
Testing & Build Tooling 11
| Module | Version | Why we use it |
|---|---|---|
github.com/moby/patternmatcher | v0.6.1 | Applies .dockerignore patterns when preparing the files sent to Docker for lab image builds. |
mvdan.cc/sh/v3 | v3.14.1 | Parses Bash commands so the agent safety checks can inspect the commands a session is about to run. |
github.com/stretchr/testify | v1.12.1 | Assertion and require helpers used across the Go unit test suite. |
github.com/gokrazy/tools | v0.0.0-20261026191944-942a8faaca93 | Drives gokrazy appliance image builds from Ze's appliance build tooling. |
github.com/gokrazy/updater | v0.0.0-20260620140544-0a84d8ab3878 | Referenced only in a regression test against Ze's own vendored update-push logic, written locally after a bug was found upstream. Not used in production. |
github.com/sivchari/gomu | v0.3.0 | Mutation-testing tool, run as a native Go command to advisory-score how well the test suite exercises the code. Not a build or CI gate. |
gopkg.in/yaml.v3 | v3.0.1 | Parses GitHub Actions workflow YAML in verification tests so aliases, duplicate keys, and malformed trigger structures fail closed. |
github.com/golangci/golangci-lint/v2 | v2.15.0 | The linter behind ./le go lint run, pinned through the tools.go tracking file so every machine and every CI job lints with one version. |
honnef.co/go/tools | v0.8.2 | Staticcheck, run beside golangci-lint from the same tools.go pin, for the analyses golangci-lint does not carry. |
github.com/yuin/goldmark | v1.8.7 | Renders the Markdown of docs/ and the website into the published HTML pages, in the Go site build that replaced the retired Python renderers. |
github.com/anmitsu/go-shlex | v0.0.0-20200514113438-38f4b401e2be | Splits an operator-typed command line into words for the stress-reproduction runner, so a quoted argument survives. |