rkik

User Guide

This guide explains how to install and use RKIK to probe and compare NTP servers.

Installation

AUR (Arch Linux and derivatives)

A development package rkik-git is available:

git clone https://aur.archlinux.org/rkik-git.git
cd rkik-git
makepkg -si

With a helper (example yay):

yay -S rkik-git

Nix / NixOS

RKIK is packaged in nixpkgs as rkik (availability/version depends on the channel):

# temporary shell
nix shell nixpkgs#rkik
# install into user profile
nix-env -iA nixpkgs.rkik

Binaries / Linux packages

Archives and .deb/.rpm are published in GitHub Releases.

# Debian/Ubuntu
sudo apt install ./rkik_X.Y.Z-R_amd64.deb

# Fedora/RHEL/Alma/Rocky
sudo dnf install rkik-X.Y.Z-R.x86_64.rpm

From source

git clone https://github.com/aguacero7/rkik.git
cd rkik
cargo build --release
sudo install -m 0755 target/release/rkik /usr/local/bin/rkik

Usage

Probe a single server

rkik pool.ntp.org
rkik --server time.cloudflare.com

Compare multiple servers (asynchronous)

rkik --compare time.google.com,time.cloudflare.com,0.de.pool.ntp.org
rkik --compare time1 time2 time3 --format json

IPv6-only

rkik -6 --server 2.pool.ntp.org -j

Output formats

• --format text (default) — human-readable.
• --format json — detailed, stable.
• --format simple — minimal text (timestamp, name/port).
• --format json-short — compact ({"utc": "...", "name": "...", "port": 123}). Aliases: -j/--json, -S/--short.

Continuous mode

# two measurements, 1s apart
rkik --server time.cloudflare.com --count 2 --interval 1 --short

# infinite loop (Ctrl-C to stop)
rkik --server time.google.com --infinite --format json

For ingestion into a SIEM/log pipeline, prefer --format json and collect one JSON object per line.

Targets host[:port]

rkik time.google.com:123
rkik [2606:4700:f1::123]:123

Colors

Disable all coloring:

rkik --no-color
# or environment variable
NO_COLOR=1 rkik ...

Troubleshooting

• Resolution failed: check DNS / try -6 if needed.
• Timeout: open UDP/123.
• Inconsistent offsets: verify local clock and repeatability.

FAQ

• IPv6 supported? Yes, -6.
• More than 2 servers? Yes, --compare accepts N≥2, all in parallel.
• Adjust the system clock? Yes, --sync requirements: (Unix, root)

This site is open source. Improve this page.