Find file History
Pull request Compare This branch is 2 commits ahead, 254 commits behind chef-boneyard:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Installs and configures ntp, optionally set up a local NTP server.



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


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


Should work on any Red Hat-family or Debian-family Linux distribution.


  • ntp[:is_server]

    • Boolean, should be true or false, defaults to false
  • ntp[:servers] (applies to NTP Servers and Clients)

    • Array, should be a list of upstream NTP public servers. The NTP protocol works best with at least 3 servers. The NTPD maximum is 7 upstream servers, any more than that and some of them will be ignored by the daemon.
  • ntp[:peers] (applies to NTP Servers ONLY)

    • Array, should be a list of local NTP private servers. Configuring peer servers on your LAN will reduce traffic to upstream time sources, and provide higher availability of NTP on your LAN. Again the maximum is 7 peers
  • ntp[:restrictions] (applies to NTP Servers only)

    • Array, should be a list of restrict lines to restrict access to NTP clients on your LAN.


Set up the ntp attributes in a role. For example in a base.rb role applied to all nodes:

name "base"
  "ntp" => {
    "servers" => ["", ""]

Then in an ntpserver.rb role that is applied to NTP servers (e.g.,

name "base"
  "ntp" => {
    "is_server" => "true",
    "servers" => ["", ""]
    "peers" => ["", ""]
    "restrictions" => [" mask nomodify notrap"]

The used in these roles should be the names or IP addresses of internal NTP servers.


Author:: Joshua Timberman (

Copyright 2009-2011, Opscode, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.