FreeBSD 15 – ntpd not synchronizing system clock with upstream peers – Fix & Prevention

📖 ~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

Time drift causes auth failures, certificate errors, and distributed system instability.

Environment & Reproduction

Common on hosts behind restrictive egress policy or bad NTP server entries.

service ntpd status
ntpq -p
date -u

Root Cause Analysis

NTP traffic blocked or server config invalid prevents disciplined clock correction.

Quick Triage

Assess ntpd process health and UDP/123 reachability.

sockstat -4 -6 -l | grep ntpd
service ntpd onestatus
ntpdate -q pool.ntp.org

Step-by-Step Diagnosis

Inspect ntp.conf peers and packet flow to configured upstream servers.

grep -v '^#' /etc/ntp.conf
tcpdump -ni any udp port 123 -c 30
ntpq -pn

Solution – Primary Fix

Enable ntpd with trusted pools and step clock once before steady sync.

sysrc ntpd_enable="YES"
sysrc ntpd_sync_on_start="YES"
service ntpd restart

Solution – Alternative Approaches

Use local stratum server or one-time ntpdate during restricted maintenance windows.

ntpdate -u 0.pool.ntp.org

Verification & Acceptance Criteria

Offset converges and selected peer remains stable over monitoring window.

ntpq -p
ntpdate -q pool.ntp.org
date -u

Rollback Plan

Restore previous ntp.conf if peer changes violate policy.

cp -a /etc/ntp.conf.bak /etc/ntp.conf
service ntpd restart

Prevention & Hardening

Alert on clock drift and maintain redundant NTP sources.

sysrc | grep ntpd
ntpq -p

Related Errors & Cross-Refs

Frequently paired with TLS handshake failures and Kerberos clock-skew messages.

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

View all FreeBSD 15 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

FreeBSD time synchronization and ntpd operational guidance.