✨ New: Try our AI‑powered Search (Ctrl + K) — Read more

ntp

Prev Next

ntp add

ntp add - Add an NTP server to the list of configured servers

Description:
Add an NTP (Network Time Protocol) server to the list of servers that may be used by the NTP client service to perform time synchronization.

Syntax:

  ntp add <clock-name> <server-address>

  <clock-name>     = <string>
  <server-address> = <ip-addr> | <dns-name>

Parameters:

Parameter Description
clock-name Unique identifier of a clock.
server-address The IP address or domain name of the NTP server to add.

ntp delete

ntp delete - Delete an NTP server from the list of configured servers.

Description:
Delete an NTP (Network Time Protocol) server from the list of servers that may be used by the NTP client service to perform time synchronization.

Syntax:

  ntp delete <clock-name> <server-address>

  <clock-name>     = <string>
  <server-address> = <ip-addr> | <dns-name>

Parameters:

Parameter Description
clock-name Unique identifier of a clock.
server-address The IP address or domain name of the NTP server to add.

ntp disable

ntp disable - Disable the NTP client service

Description:
Disable the NTP (Network Time Protocol) client service and stop performing time synchronization with an NTP server.

Syntax:

  ntp disable <clock-name>

  <clock-name> = <string>

Parameters:

Parameter Description
clock-name Unique identifier of a clock.

ntp edit

ntp edit - Modify the NTP client service and the time zone configuration

Description:
Modify the NTP (Network Time Protocol) client service configuration to control how time synchronization with an NTP server is performed. Modify the time zone and daylight saving time configuration.

Syntax: for local clock:

  ntp edit <clock-name> { {dscp <0-63>} |
                          {vlan-priority <0-7>} |
                          {nbr-messages <1-6>} |
                          {time-interval <8-256>} |
                          {tai-offset <decimal>} |
                          {dst <enable | disable>} |
                          {utc-hour <(-12)-(+14)>} |
                          {utc-min <0-59>} |
                          {dst-hour <0-23>} |
                          {dst-min <0-59>} |
                          {dst-start-month <month>} |
                          {dst-start-week  <1-5>} |
                          {dst-start-day   <day>} |
                          {dst-start-hour  <0-23>} |
                          {dst-start-min   <0-59>} |
                          {dst-end-month <month>} |
                          {dst-end-week  <1-5>} |
                          {dst-end-day   <day>} |
                          {dst-end-hour  <0-23>} |
                          {dst-end-min   <0-59>} }+

  <clock-name>  = <string>

Parameters:

Parameter Description
clock-name Unique identifier of a clock.
dscp The DiffServ Code Point priority to use.
vlan-priority The packet priority set in the VLAN priority bits when using a VLAN.
nbr-messages The number of messages sent to the NTP server during a request.
time-interval The time interval between requests to the NTP server (in seconds). Acceptable values are integers that are factors of two and range from 8 to 256.
tai-offset Offset in seconds to convert UTC time to TAI (Temps Atomique International).
dst For regions of the world implementing Daylight Saving Time, (DST), this can be enabled. Be aware that syslog and other services that timestamp events using the current date and time will be affected during transitions of DST periods. There will possibly be an hour gap or duplicate time stamps because the clock was set back.
utc-hour Hour offset from Coordinated Universal Time. North America would have negative values while Eastern Europe would have positive values.
utc-min Minute offset from Coordinated Universal Time.
dst-hour Daylight Saving Time hour offset.
dst-min Daylight Saving Time minute offset.
dst-start-month
dst-start-week
dst-start-day
dst-start-hour
dst-start-min
Period where Daylight Saving Time starts. The events are described as: "the change will take place on the nth (week) of (month) on a (day) at (hour) (min)". To configure the last day of the month, use week=5.
dst-end-month
dst-end-week
dst-end-day
dst-end-hour
dst-end-min
Period where daylight saving time ends. The events are described as: "the change will take place on the nth (week) of (month) on a (day) at (hour) (min)". To configure the last day of the month, use week=5.

ntp enable

ntp enable - Enable selected configured NTP servers

Description:
Select the NTP (Network Time Protocol) server to use when performing time synchronization. Up to two NTP servers may be enabled, but only one will be active at a time. Note that this command also starts the NTP client service.

Syntax: for local clock:

ntp enable <clock-name> <server1-address> [<server2-address>]
<clock-name>      = <string>
<server1-address> = <ip-addr> | <dns-name>
<server2-address> = <ip-addr> | <dns-name>

Parameters:

Parameter Description
clock-name Unique identifier of a clock.
server1-address The IP address or domain name of the primary NTP server to enable.
server2-address The IP address or domain name of the optional secondary NTP server to enable.

ntp show

ntp show - Show the current NTP client service configuration and status.

Description:
Show the current NTP (Network Time Protocol) client service configuration and status. Show the time zone configuration.

Syntax:

  ntp show <clock-name> [ [ -d [ -D [ -E ] ] ] |
                        [ -r ] ]

  <clock-name> = <string>

Parameters:

Parameter Description
clock-name Unique identifier of a clock.
-d Used to display additional information.
-D Used to display servo status information.
-E Used to display stack inbound information.
-r Used to reset ntp peaks.

© 2026 Cisco and/or its affiliates. All rights reserved.

For more information about trademarks, please visit:
Cisco trademarks 
For more information about legal terms, please visit:
Cisco legal terms