Development repository for Opscode Cookbook ntp
Switch branches/tags
Nothing to show
Pull request Compare This branch is 25 commits ahead, 37 commits behind atomic-penguin:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

NTP Build Status


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


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


  • 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.
  • ntp[:driftfile]

    • String, the path to the frequency file.
  • ntp[:statsdir]

    • String, the directory path for files created by the statistics facility.


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

name "base"
description "Role applied to all systems"
  "ntp" => {
    "servers" => ["", ""]

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

name "ntp_server"
description "Role applied to the system that should be an NTP server."
  "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.

License and Author

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.