# vergoh/vnstat

vnStat - a network traffic monitor for Linux and BSD

Repository: https://github.com/vergoh/vnstat
Canonical: https://ross.abutalabs.com/products/vnstat
Language: C
License: GPL-2.0
License Family: copyleft
Topics: vnstat, c, traffic, network-traffic-monitor
Last push: 2026-08-07T21:22:17+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 8, longevity 100
- inputs: {"age_days": 4573, "days_push": 26, "days_rel": 571, "gap_med": null, "n_releases_24m": 1}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1767, forks 139 (observed 2026-08-28T04:05:33.608015+00:00)

## What it is
vnStat is a console-based network traffic monitor for Linux and BSD that tracks bandwidth usage using kernel interface statistics rather than sniffing packets, keeping resource usage minimal. It stores traffic history at five-minute, hourly, daily, and yearly granularity with configurable retention, and can optionally render usage graphs as images.

## Use cases
- monitor bandwidth usage on a linux server
- track monthly network traffic per interface
- see how much data my vpn or router interface used
- log network traffic history without packet sniffing
- view daily and hourly bandwidth statistics from the terminal
- monitor traffic on a low-resource embedded or bsd system

## When to choose
- you need lightweight, long-term bandwidth accounting without capturing packets
- you want historical traffic reports (hourly/daily/monthly/yearly) from the command line
- you run Linux or BSD servers, routers, or embedded devices and need low-overhead monitoring

## When to avoid
- you need real-time per-connection or per-application traffic analysis (use tools like ntopng or Wireshark)
- you need packet-level inspection or protocol breakdowns
- you require a GUI dashboard out of the box

## Facets
- artifact type: cli-tool
- maturity: stable
- function: monitoring, analytics, cli
- domain: networking, monitoring
- platform: bsd, cli, self-hosted
- tags: network-traffic-monitor, bandwidth-usage, kernel-statistics, c, command-line, devops, linux, docker

## Member repositories
- vergoh/vnstat (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:33.608015+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:26:25.335751+00:00, confidence not recorded.
  - readme: https://github.com/vergoh/vnstat (fetched 2026-08-28T04:05:33.608015+00:00, sha a15db1ddbd14)
- Data as of 2026-08-30T08:39:29.467469+00:00.