FreeBSD 14 – ntpd fails to synchronize and system time drifts beyond tolerance

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Clock drift breaks TLS validation, Kerberos, and distributed transaction consistency.

Environment & Reproduction

Typically observed after network ACL changes, upstream NTP outages, or driftfile corruption.

service ntpd status
ntpq -pn
date -u

Root Cause Analysis

NTP peers are unreachable or rejected, leaving local oscillator uncorrected.

Quick Triage

Check UDP/123 reachability and ntpd startup options.

sockstat -4 -l | grep 123
sysrc ntpd_enable ntpd_sync_on_start
ntpdate -q pool.ntp.org

Step-by-Step Diagnosis

Inspect peer states, leap indicators, and network path quality.

ntpq -c rl
ntpq -c as
traceroute -U -p 123 

Solution – Primary Fix

Reset drift state, sync once, and restart daemon with valid peer list.

service ntpd stop
rm -f /var/db/ntpd.drift
ntpdate -b pool.ntp.org
service ntpd start

Solution – Alternative Approaches

Use chrony when workload needs faster convergence under variable latency.

pkg install -y chrony
service chronyd enable
service chronyd start

Verification & Acceptance Criteria

Offset converges within policy threshold and stable selected peer is present.

ntpq -pn
ntpstat || true
date -u

Rollback Plan

Return to previously known-good ntp.conf and daemon package if regressions appear.

cp /root/backup/ntp.conf /etc/ntp.conf
service ntpd restart

Prevention & Hardening

Define multiple upstream peers and monitor offset/jitter continuously.

grep -E '^server' /etc/ntp.conf
logger -t ntp 'peer health checked'

Related Errors & Cross-Refs

Drift-related TLS certificate errors and token validation failures often follow.

Related tutorial: View the step-by-step tutorial for FreeBSD 14.

View all FreeBSD 14 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

ntpd manuals and FreeBSD time synchronization guidance.