Docs Config NTP

NTP

Some devices (especially routers and boxes) tend to drift out of sync with the correct time, which can cause TLS certificate validation to fail. Enabling the built-in NTP client periodically corrects the clock and helps avoid these connection failures.

Example Config

config.yaml YAML

ntp:
  enable: true
  write-to-system: true
  server: time.apple.com
  port: 123
  interval: 30
  # dialer-proxy: DIRECT

Field Reference

enableRequired

Whether to enable the NTP service.

write-to-systemOptional

Whether to write the corrected time to the system clock — this only takes effect when running with root/administrator privileges.

serverDefault: time.apple.com

The NTP server address.

portDefault: 123

The NTP server port.

intervalDefault: 30

Sync interval, in minutes.

dialer-proxyDefault: DIRECT

By default, NTP connects directly to the target server, bypassing outbound proxies and routing rules; if the NTP server isn't reachable directly, use this field to force it through a specific proxy.