Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

geerlingguy/chronytop

DevOps & Self-hosting

A btop-style terminal dashboard for monitoring chrony NTP servers, their clients and host resource use.

111
7
Go
MIT
1 day old

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.

  1. 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
    
  2. Run it with elevated privileges:

    sudo chronytop
    
  3. Use keys 1–7 to show or hide panels, +/- to slow or speed up sampling, ? or h for help, q or Esc to quit. You can also set the sample interval with -i (default 1s, range 500ms to 10s) and the client listing threshold with -p (default 100 packets).

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/... under sudo) and restored on the next run; -i overrides 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 /proc and runs chronyc by 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

  1. henrygd/beszelA lightweight, self-hosted hub for monitoring servers and Docker containers, with history and alerts.Go26,509
  2. prometheus/prometheusCollect, query and alert on service metrics with a self-contained, pull-based monitoring server.Go66,858
  3. VictoriaMetrics/VictoriaMetricsA time series database and monitoring backend for teams that need to store and query large volumes of metrics.Go17,913
  4. ValidatorStack/solana-vigilRead-only monitoring and host auditing for Linux Solana validators, covering VAT runway, BLS, duties and alerts.Go133
  5. gnacho/netpulseSelf-hosted dashboard for OpenWrt and GL.iNet home networks with live health, devices, WireGuard and AdGuard stats.Go332