geerlingguy/chronytop
DevOps & Self-hostingA btop-style terminal dashboard for monitoring chrony NTP servers, their clients and host resource use.
What it does
chronytop is a terminal UI for operators of chrony NTP time servers, styled after btop. It graphs NTP requests per second and shows server counters, the clients chronyd is rate-limiting most heavily, sources, tracking data, bandwidth, and CPU and memory use including chronyd's. Panels resize with the terminal and can be toggled individually.
It is a single static Go binary that reads from /proc and /usr/bin/chronyc and does not open network connections. Point it at a host running chrony and it visualizes the daemon's statistics.
Quick start
You need Linux with chrony 4.0 or later (/usr/bin/chronyc) and root or sudo for the server and offenders panels.
-
Download the binary for your architecture from Releases, then install it:
sudo install -o root -g root -m 755 chronytop-linux-amd64 /usr/local/bin/chronytop -
Run it with elevated privileges:
sudo chronytop -
Use keys
1–7to show or hide panels,+/-to slow or speed up sampling,?orhfor help,qorEscto quit. You can also set the sample interval with-i(default1s, range 500ms to 10s) and the client listing threshold with-p(default100packets).
Alternatively, build from source with Go 1.24 or later:
CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o chronytop .
Running without root
Tracking, sources, net and system panels work for any user. The server and offenders panels rely on chronyd's serverstats and clients commands, which are answered over the Unix socket in /run/chrony by default.
With chrony 4.7 or later, allow those commands for local users by putting opencommands activity manual rtcdata smoothing sourcename sources sourcestats tracking serverstats clients in chrony.conf, then restart chronyd. On older versions, adding your user to chrony's group only works where that group can write to /run/chrony; Debian and Ubuntu create the directory as 0700, so sudo remains necessary there. Group membership grants full access to chronyd's control socket, not just statistics. See Running without root for the exact steps.
Constraints and safety notes
- chrony 4.0 or later and a Linux host are required; other operating systems are not covered.
- Settings such as visible panels and sample interval are persisted to
~/.config/chronytop/chronytop.conf(/root/.config/...undersudo) and restored on the next run;-ioverrides the saved interval. - The offenders list refreshes every 10 seconds in the background so it stays cheap on busy public servers.
- Because it usually runs as root, chronytop only reads
/procand runschronycby absolute path without a shell, writes only its settings file to a user-owned path via a temporary file, and strips non-printable characters from displayed chrony data. - Licensed under MIT.
HotRepo's take
chronytop was recorded on the GitHub new-project list for Go on 2026-11-18 with 102 stars gained and 5 forks in a window of roughly 16 hours; no best daily rank was recorded. With a single data point, this is an early reception snapshot rather than a trend. The choice of a btop-like interactive layout for chrony, which otherwise offers mostly command-line output, is the main practical differentiator; the value is highest for people running public or busy NTP servers who need to spot rate-limited clients quickly.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- henrygd/beszelA lightweight, self-hosted hub for monitoring servers and Docker containers, with history and alerts.
- prometheus/prometheusCollect, query and alert on service metrics with a self-contained, pull-based monitoring server.
- VictoriaMetrics/VictoriaMetricsA time series database and monitoring backend for teams that need to store and query large volumes of metrics.
- ValidatorStack/solana-vigilRead-only monitoring and host auditing for Linux Solana validators, covering VAT runway, BLS, duties and alerts.
- gnacho/netpulseSelf-hosted dashboard for OpenWrt and GL.iNet home networks with live health, devices, WireGuard and AdGuard stats.