ntp (95) Versions 7.0.1 Follow250

Provides the ntp_service custom resource for managing distro-packaged NTPsec

Policyfile

Berkshelf

Knife

cookbook 'ntp', '~> 7.0.1', :supermarket

cookbook 'ntp', '~> 7.0.1'

knife supermarket install ntp

knife supermarket download ntp

README

Dependencies

Changelog

Quality 50%

NTP Cookbook

The ntp cookbook now provides a single custom resource, ntp_service, for
managing the distro-packaged NTP service on current Debian, Ubuntu, and
Enterprise Linux 9+ releases.

Supported Platforms

Debian 12+
Enterprise Linux 9+
Ubuntu 22.04+

Additional platform constraints are documented in
[LIMITATIONS.md](LIMITATIONS.md).

Resource

`ntp_service`

Use ntp_service to install the platform-appropriate NTP package, render the
packaged config file, and enable the packaged systemd service.

ntp_service 'default' do
  servers %w(0.pool.ntp.org 1.pool.ntp.org 2.pool.ntp.org 3.pool.ntp.org)
end

See [documentation/ntp_ntp_service.md](documentation/ntp_ntp_service.md) for
the full property reference.

Testing

cookstyle
chef exec rspec
KITCHEN_LOCAL_YAML=kitchen.dokken.yml kitchen test default-ubuntu-2404 default-rockylinux-9 --destroy=always

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

ntp Cookbook CHANGELOG

This file is used to list changes made in each version of the ntp cookbook.

Standardise files with files in sous-chefs/repo-management
Standardise files with files in sous-chefs/repo-management

7.0.1 (2026-04-20)

Bug Fixes

suppress implicit default servers for pool-only configs (#278) (fe710a6)

7.0.0 (2026-04-20)

⚠ BREAKING CHANGES

migrate NTP to custom resources (#276)

Features

migrate NTP to custom resources (#276) (52a9eaa)

Bug Fixes

apparmor (8aadb54)
apparmor warnings (354a326)
apparmor: dev-log (3ec6b43)
ci: Update workflows to use release pipeline (#272) (e0aa6f1)
pass slack secrets to release workflow (34594dc)
pin release workflow to 5.0.3 (d0dafa4)

5.2.6 (2025-10-15)

Bug Fixes

ci: Update workflows to use release pipeline (#272) (e0aa6f1)

5.2.3 - 2024-11-18

Standardise files with files in sous-chefs/repo-management

5.2.2 - 2024-07-15

Update ntpd package for Enterprise Linux 9 (ie Oracle, Rocky, Alma)

5.2.1 - 2024-07-15

Standardise files with files in sous-chefs/repo-management

5.2.0 - 2024-07-15

Added capability to set logconfig using an attribute

5.0.18 - 2024-01-24

Updated readme this cookbook only support chef 15.5+

Remove support for debian-8 / debian-9 / debian-10 / oraclelinux-7 / opensuse-leap-15
Adds support for debian-11 / debian-12

Redhat removed support for ntp in favor of chrony: (https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/considerations_in_adopting_rhel_8/index#time-synchronization_infrastructure-services)

since debian bookworm the ntp user is ntpsec (i expect debian will continue to use this in all later versions)

for debian / redhat based os'es there is a leap-second file, prefer to use this.

updated changelog file, removed links to tickets.opscode.com as the markdown link check failed

https://chefcommunity.slack.com/archives/C2V7B88SF/p1706892623188809

5.0.15 - 2023-11-01

Standardise files with files in sous-chefs/repo-management

5.0.7 - 2023-04-01

Standardise files with files in sous-chefs/repo-management

5.0.5 - 2023-03-20

Standardise files with files in sous-chefs/repo-management

5.0.4 - 2023-03-15

Standardise files with files in sous-chefs/repo-management

5.0.3 - 2023-02-23

Standardise files with files in sous-chefs/repo-management

5.0.1 - 2023-02-16

Fix 'restrict default' syntax

5.0.0 - 2023-02-16

Remove local clock feature, this is no longer recommended

4.0.0 - 2023-02-16

Remove Delivery

3.12.5 - 2023-02-16

Standardise files with files in sous-chefs/repo-management

3.12.4 - 2023-02-15

Standardise files with files in sous-chefs/repo-management

3.12.3 - 2022-12-11

Standardise files with files in sous-chefs/repo-management

3.12.2 - 2022-02-08

Remove delivery folder

3.12.1 - 2022-02-03

Standardise files with files in sous-chefs/repo-management

3.12.0 - 2021-11-09

Updates the ntp.conf template to allow setting dscp value; This is to support Cisco Application Centric Infrastructure (ACI) for RedHat.
Value is set to nil, as this will only be set if you require Differentiated Services Control Point (DSCP).

3.11.0 - 2021-10-14

Updates the ntp.conf template to allow setting tos maxdist value; helpful when ntpd uses a remote Windows server as a time source
Sets the default tos maxdist value to 1 to stay conformed to ntpd's default value; can be set to 30 when remote ntp server is a Windows domain controller, for example.

3.10.2 - 2021-08-30

Standardise files with files in sous-chefs/repo-management

3.10.1 - 2021-06-01

Standardise files with files in sous-chefs/repo-management

3.10.0 - 2021-05-26

Fix fedora tests by omitting the latest distro version

3.9.1 - 2021-02-03

Remove duplicated source attributes in cookbook_file for leapfile_url

3.9.0 - 2021-01-29

Sous Chefs Adoption
Cookstyle fixes
Standardise files with files in sous-chefs/repo-management
Add testing for Windows and MacOS

3.8.0 (2020-12-04)

Changed installing ntp.leapseconds file dynamicaly from (or other). Use node['ntp']['leapfile_url'] to override - @mnosenko
Improve how we inject the helper libraries - @tas50
Require Chef 12.15+ - @tas50
Add testing in Github actions - @tas50
Fix failing specs - @tas50

3.7.0 (2019-10-01)

Resolve multiple AppArmor failures on Ubuntu systems - @caarlos0
Rename Mac OS X references to be macOS - @tas50
Resolve multiple cookstyle warnings - @tas50
Added RHEL 8, Debian 10, and openSUSE 15 testing - @tas50
Update the Windows NTP client to the latest version - @tas50
Remove support for EOL SLES 11 - @tas50
Gracefully fail on RHEL 8 and later - @tas50
Update the supported platforms to include opensuse - @tas50
Update to the latest ntp.leapseconds file - @tas50

3.6.2 (2019-01-21)

Update leap seconds file to the latest expiring 6/2019 - @tas50

3.6.1 (2018-11-24)

Add the attach_disconnected flag to the ntpd AppArmor config

3.6.0 (2018-07-24)

Don't add defaults if pools or peers are specified

3.5.6 (2018-01-28)

Add /var/log/ntpstats/protostats to Apparmor config

3.5.5 (2018-01-28)

Update leap second file. Now expires Dec 2018

3.5.4 (2017-11-27)

Update ntp.leapseconds (expires: 1 Dec 2017 → 28 June 2018)

3.5.3 (2017-11-27)

Fix failing non-interactive install on Solaris10

3.5.2 (2017-08-16)

Fix apprarmor denied for sock_type=dgram in ubuntu dists.

3.5.1 (2017-06-28)

Use the latest NTP release on windows to resolve several bugs
Fix Amazon Linux support on Chef 13
Allow windows to sync to the hardware clock when not virtualized since Ohai has provided Windows with virtualization data for a while now
Update inspec tests to pass on Windows
Update Chefspecs for the latest platforms

3.5.0 (2017-06-27)

Change RHEL platforms to use the driftfile location RHEL ships out of the box
Add support for ntp pool configuration option
Fix installation and config on Solaris 10 & 11.
Set default service name on SLES 11.x
Fix MacOS X default attributes and OSX chefspec.

3.4.0 (2017-05-06)

Ensure metadata compatibility with older Chef 12 releases
Testing updates for Chef 13
Test with Delivery local mode instead of a Rakefile
Use a SPDX standard license string
Remove xcp as a platform in the metadata
Added requestkey attribute

3.3.1 (2016-12-21)

Fix resource cloning warning in recipe[default]

3.3.0 (2016-12-16)

Add Mac OS X client config support

3.2.1 (2016-11-23)

Update leap seconds file to version 3676924800

3.2.0 (2016-09-28)

Remove support for Arch
Remove legacy apparmor config that wasn't used
Don't install ntpdate (and uninstall it) on Ubuntu 16.04+
Expand specs and avoid deprecation warnings

3.1.0 (2016-09-16)

Require Chef 12.1 not 12.0
Remove the dependency on the Windows cookbook

3.0.0 (2016-09-07)

Require Chef 12+

2.0.3 (2016-08-31)

Remove minitest tests from the undo recipe

2.0.2 (2016-08-30)

Replace node.set with node.normal to avoid deprecation notices

2.0.1 (2016-08-29)

Update the leap seconds file
Remove node name from configs
Switch to cookstyle and use the Rakefile directly for testing in Travis CI
Update platforms we test on
Fix failing Chefspecs and avoid deprecation warnings during spec runs

v2.0.0 (2016-05-18)

Remove the undo recipe. This functionality is better suited for a custom cookbook that matches the needs of individual organizations
Removed the installation of the visual studio 2008 runtime that was only necessary for Windows 2003.
Fixed the forced clock syncing on FreeBSD hosts

v1.11.1 (2016-05-12)

Ownership of this cookbook has been transferred back to Chef Software.

v1.11.0 (2016-03-29)

When force setting the clock run ntp as the ntp user to ensure we don't set file ownership to root
Added optional support for orphan mode
Require windows cookbook 1.38.0 to resolve several issues with the older cookbook versions
Add support for using keys

v1.10.1 (2016-02-04)

Update the Readme to include openSUSE and Arch Linux
Guard the timeout set in the service to prevent failures on old chef releases

v1.10.0 (2016-02-04)

Fixed compatibility with FreeBSD hosts by skipping the sync with the hardware clock and using the proper path to the "true" command
Fixed compatibility with Windows by extending the service start timeout, introducing retries, and excluding Windows from the hardware sync logic
Changed the default array of packages to install from ntp and ntpdate to just ntp. ntpdate is used on Debian and modern RHEL/Fedora hosts only. This gives us out of the box support for Arch and Suse
Ensure that Fedora systems also install ntpdate
Updated test dependencies to the latest
Updated test documentation to point to the official Chef testing documentation
Expanded the Test Kitchen config with better support for FreeBSD/Fedora and new Windows boxes

v1.9.2 (2016-02-04)

PR [#121] - Remove nomodify config from loopback

v1.9.1 (2016-01-07)

PR [#132] - Update ntp.leapseconds

v1.9.0 (2015-12-16)

PR [#111] - Fix duplication of localhost listen directive in template
PR [#127] - Set var_owner on FreeBSD to root instead of default ntp
PR [#117] - Document node['ntp']['ignore']
PR [#118] - Add attributes to support pld-linux
PR [#120] - Fix links to Github PRs in the Changelog
PR [#124] - Additional fix for apparmor issue gmiranda23#103

Depend on windows cookbook instead of suggesting. Suggests doesn't actually do anything
Fix / expand apparmor specs to pass and test the auto apparmor config logic
Enable Travis CI and update the travis.yml file to run full integration tests with Kitchen Docker so we test all PRs on Ubuntu 12.04/14.04 and CentOS 6.7 / 7.1
Reformat all markdown files
Update all references to Opscode to be Chef Software.
Update copyright dates and contact e-mails
Expanded platforms in the Test Kitchen config
Added new supermarket issues_url and source_url metadata
Update the Berkfile API url and removed version pins on the testing cookbooks
Remove yum from the Berksfile as it isn't actually used
Use the standard Chef testing Rakefile
Remove the attribute documentation from the metadata as it is quickly out of sync
Resolve rubocop warnings and include the standard Chef rubocop.yml file
Update development deps in the Gemfile to the latest releases
Remove the outdated contributing.md doc from the Opscode days

v1.8.6 (2015-05-14)

PR [#102] - Update leapseconds file to 3660249600 (through C49)

Gemfile parity with ChefDK 0.5.1
.kitchen.yml platform updates to current bento boxes

v1.8.4 (2015-04-17)

PR [#101] - add logfile attribute

v1.8.2 (2015-04-15)

PR [#100] - Sort peers & servers for consistency

v1.8.0 (2015-04-13)

Chefspec 4.0 updates
Rubocop updates PR [#85] - Update leapseconds for June 2015 leapsecond PR [#70] - Allow setting tinker options in attributes PR [#84] - Add attributes for tinker option customization PR [#88] - Attribute sets noquery for localhost lines PR [#89] - ntp.leapseconds notifies ntp service with delayed restart PR [#91] - Allow ntp.conf update to restart immediate PR [#95] - Add preferred ntp server support PR [#96] - Add restrict default attribute PR [#72] - Move high stratum real CMOs to an attribute PR [#98] - Bump test-kitchen gem version PR [#99] - Lazy attribute for leapfile_enabled

v1.7.0 (2014-12-10)

Added CentOS 7 support for test-kitchen PR [#37] - Check that apparmor exists before enabling service PR [#45] - Statistics logging switch (not available for Windows) PR [#57] - Move include statement on helper outside 'windows?' check PR [#71] - Ability to listen more than one interface PR [#73] - Fix appamor configuration for Ubuntu PR [#74] - Remove is_server from example PR [#75] - Add more settings for server and peer declarations PR [#83] - Fix apparmor spec tests

v1.6.8 (2014-12-04)

PR [#81] - Update to berkshelf3

v1.6.6 (2014-12-02)

PR [#76] - Overhauled Testing
PR [#68] - Updated Leapseconds
PR [#51] - Berksfile source deprecation

v1.6.5 (2014-09-25)

Ensure that ntp version is captured

v1.6.4 (2014-07-02)

Leapseconds File Expired, update to 3626380800 [COOK-3887] - Trivial changes to achieve Gentoo support [COOK-1876] - ntp leapfile assumes ntpd >= 4.2.6 syntax

v1.6.2 (2014-03-19)

[COOK-4162] - change "No NTP servers specified" message to :debug

v1.6.0 (2014-02-21)

Improvement

[COOK-4346] - Solaris 11 support for ntp
[COOK-4339] - Disable Monitoring by Default
[COOK-3604] - Enable listening on specific interfaces

Bug

[COOK-4106] - Check for default content in ntp.conf
[COOK-4087] - quote option in readme
[COOK-3797] - Cookbook fails to upload due to 1.9.x syntax
[COOK-3023] - NTP leapseconds file denied by Ubuntu apparmor profile

v1.5.4 (2013-12-29)

[COOK-4007]- update to 3612902400

v1.5.2

Bug

[COOK-3797] - Add /spec to Chefignore

v1.5.0

Improvemen

[COOK-3651] - Refactor and clean up
[COOK-3630] - Switch NTP cookbook linting from Tailor to Rubocop
[COOK-3273] - Add tests

New Featur

[COOK-3636] - Allow ntp cookbook to update clock to ntp servers

Bug

[COOK-3410] - Remove redundant ntpdate/disable recipes
[COOK-1170] - Allow redefining NTP servers in a role

v1.4.0

Improvemen

[COOK-3365] - Update ntp leapseconds file to version 3597177600
[COOK-1674] - Add Windows support

v1.3.2

[COOK-2024] - update leapfile for IERS Bulletin C

v1.3.0

[COOK-1404] - add leapfile for handling leap seconds

v1.2.0

[COOK-1184] - Add recipe to disable NTP completely
[COOK-1298] - Refactor into a reference cookbook for testing

v1.1.8

[COOK-1158] - RHEL family >= 6 has ntpdate package

v1.1.6

Related to changes in COOK-1124, fix group for freebsd and else

v1.1.4

[COOK-1124] - parameterised driftfile and statsdir to be configurable by platform

v1.1.2

[COOK-952] - freebsd support
[COOK-949] - check for any virtual system not just vmware

v1.1.0

Fixes COOK-376 (use LAN peers, iburst option, LAN restriction attribute)

v1.0.1

Support scientific linux
Use service name attribute in resource (fixes EL derivatives)

Collaborator Number Metric

7.0.1 passed this metric

Contributing File Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric

7.0.1 passed this metric

No Binaries Metric

7.0.1 passed this metric

Testing File Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number

Adoptable Cookbooks List

Supermarket Belongs to the Community

View our collection of guides, documentation, and articles

Select Badges

Select Supported Platforms

Select Status

NTP Cookbook

Supported Platforms

Resource

ntp_service

Testing

Dependent cookbooks

Contingent cookbooks

ntp Cookbook CHANGELOG

7.0.1 (2026-04-20)

Bug Fixes

7.0.0 (2026-04-20)

⚠ BREAKING CHANGES

Features

Bug Fixes

5.2.6 (2025-10-15)

Bug Fixes

5.2.3 - 2024-11-18

5.2.2 - 2024-07-15

5.2.1 - 2024-07-15

5.2.0 - 2024-07-15

5.0.18 - 2024-01-24

5.0.15 - 2023-11-01

5.0.7 - 2023-04-01

5.0.5 - 2023-03-20

5.0.4 - 2023-03-15

5.0.3 - 2023-02-23

5.0.1 - 2023-02-16

5.0.0 - 2023-02-16

4.0.0 - 2023-02-16

3.12.5 - 2023-02-16

3.12.4 - 2023-02-15

3.12.3 - 2022-12-11

3.12.2 - 2022-02-08

3.12.1 - 2022-02-03

3.12.0 - 2021-11-09

3.11.0 - 2021-10-14

3.10.2 - 2021-08-30

3.10.1 - 2021-06-01

3.10.0 - 2021-05-26

3.9.1 - 2021-02-03

3.9.0 - 2021-01-29

3.8.0 (2020-12-04)

3.7.0 (2019-10-01)

3.6.2 (2019-01-21)

3.6.1 (2018-11-24)

3.6.0 (2018-07-24)

3.5.6 (2018-01-28)

3.5.5 (2018-01-28)

3.5.4 (2017-11-27)

3.5.3 (2017-11-27)

3.5.2 (2017-08-16)

3.5.1 (2017-06-28)

3.5.0 (2017-06-27)

3.4.0 (2017-05-06)

3.3.1 (2016-12-21)

3.3.0 (2016-12-16)

3.2.1 (2016-11-23)

3.2.0 (2016-09-28)

3.1.0 (2016-09-16)

3.0.0 (2016-09-07)

2.0.3 (2016-08-31)

2.0.2 (2016-08-30)

2.0.1 (2016-08-29)

v2.0.0 (2016-05-18)

v1.11.1 (2016-05-12)

v1.11.0 (2016-03-29)

v1.10.1 (2016-02-04)

v1.10.0 (2016-02-04)

v1.9.2 (2016-02-04)

v1.9.1 (2016-01-07)

v1.9.0 (2015-12-16)

v1.8.6 (2015-05-14)

v1.8.4 (2015-04-17)

v1.8.2 (2015-04-15)

`ntp_service`

Collaborator Number Metric

7.0.1 passed this metric

Contributing File Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Cookstyle Metric

7.0.1 passed this metric

No Binaries Metric

7.0.1 passed this metric

Testing File Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric

7.0.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number