Vnstat

vnStat is a network traffic monitor that uses the network interface statistics provided by the kernel as information source.

  • Network Services
  • Tools & Utilities
vnStat is a network traffic monitor that uses the network interface statistics provided by the kernel as information source. This means that vnStat won't actually be sniffing any traffic and also ensures light use of system resources regardless of network traffic rate. By default, traffic statistics are stored on a five minute level for the last 48 hours, on a hourly level for the last 4 days, on a daily level for the last 2 full months and on a yearly level forever. The data retention durations are fully user configurable. Total seen traffic and a top days listing is also provided. See the official webpage or the GitHub repository for additional details and output examples. An example of the included image output is also available.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

75/100 Good

Maintained
93last commit 21 days ago
Popular
651,795 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
10064 MB minimum RAM, runs on ARM
Security check
74no serious findings, CI, tests, OpenSSF Scorecard 4.2/10

Availability: platform listings confirmed today, links checked 52 days ago

GitHub stars
1,795
Open issues
9
Last commit
2026-10-31
Latest release
v2.14
License
GPL-2.0
Activity
steady

Checked 20 days ago - source: GitHub (vergoh/vnstat)

Resources & Compatibility

Minimum requirements: 64 MB RAM, 1 CPU core(s), 100 MB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Enable vnStat so stats keep working Copy the service file (the file that tells Linux how to run vnStat), enable it, and start it so it records traffic in the background. Without this, it stops after a reboot and you lose ongoing network history. source
  • Use the systemd file on modern Ubuntu If you are on a modern Ubuntu version, use the systemd service file instead of the older Upstart file (an older Linux service system) so vnStat starts automatically. Choosing the older file can leave the traffic monitor stopped after a restart. source
  • Check the install with a version test Run vnstat --version after installing to confirm the command is available and the expected version is present. This avoids chasing missing stats when the install step itself did not finish. source

Fetched 54 days ago - each note links to its source

Alternatives

No alternatives collected yet.

Common questions

Does vnStat sniff packet contents?

No, vnStat uses the network interface statistics provided by the kernel. It does not sniff traffic, and this keeps system resource use light regardless of network traffic rate.

Why might vnStat not start after reboot on modern Ubuntu?

Use the systemd service file instead of the older Upstart file so vnStat starts automatically. Choosing the older file can leave the traffic monitor stopped after a restart.

How can I confirm vnStat installed correctly?

Run vnstat --version after installing. This confirms the command is available and the expected version is present, which avoids chasing missing stats caused by an incomplete install.

What happens to vnStat data after a power cut?

One report says a power cut or unplugging can cause vnStat to lose stats and corrupt the data, requiring a reset. A normal reboot was reported not to cause the issue.

Can vnStat be used to track WAN data usage on a router?

It has been used on GL.iNet routers to track WAN data usage. This is useful when the connection has usage caps or fees.

Answers sourced from forum.gl-inet.com, github.com, github.com, github.com, www.reddit.com

Community

Collected 53 days ago - public community threads