Skip to content

NTP

Enable NTP when the core needs a clock offset for protocols. Default settings are usually sufficient.

yaml
ntp:
  enable: true
  server: time.apple.com
  port: 123
  interval: 30
  write-to-system: false
  dialer-proxy: DIRECT
FieldHow to configure it
enableEnable time synchronization
server / portNTP server and UDP port; this example uses time.apple.com:123
intervalSynchronization interval in minutes, 30 here
dialer-proxyOutbound for requests; another node must support UDP
write-to-systemAlways disabled on Apple platforms; device time is unchanged

If synchronization fails, check UDP connectivity and the selected outbound.

Platform behavior and field status

NTP supplies a clock offset to protocols without changing device time.

6 fields shown

FieldTypeiOSmacOStvOSPlatform notes
ntp.dialer-proxyStringManaged / limitedManaged / limitedManaged / limitedConfigures time synchronization for protocol time offsets; does not change the device clock.
ntp.enableBooleanManaged / limitedManaged / limitedManaged / limitedConfigures time synchronization for protocol time offsets; does not change the device clock.
ntp.intervalIntegerManaged / limitedManaged / limitedManaged / limitedTime synchronization interval in minutes.
ntp.portIntegerManaged / limitedManaged / limitedManaged / limitedConfigures time synchronization for protocol time offsets; does not change the device clock.
ntp.serverStringManaged / limitedManaged / limitedManaged / limitedConfigures time synchronization for protocol time offsets; does not change the device clock.
ntp.write-to-systemBooleanUnsupportedUnsupportedUnsupportedAlways false; does not change the device clock.

Reference: mihomo.