{"id":13777731,"url":"https://github.com/puppetlabs/puppetlabs-ntp","last_synced_at":"2025-05-13T23:05:16.417Z","repository":{"id":39888844,"uuid":"1907413","full_name":"puppetlabs/puppetlabs-ntp","owner":"puppetlabs","description":"Puppet module to manage the NTP service","archived":false,"fork":false,"pushed_at":"2025-04-23T12:17:55.000Z","size":1217,"stargazers_count":145,"open_issues_count":9,"forks_count":328,"subscribers_count":175,"default_branch":"main","last_synced_at":"2025-05-03T01:05:18.411Z","etag":null,"topics":["hacktoberfest","module","supported"],"latest_commit_sha":null,"homepage":"http://forge.puppetlabs.com/puppetlabs/ntp","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/puppetlabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2011-06-16T19:17:38.000Z","updated_at":"2025-04-23T12:17:59.000Z","dependencies_parsed_at":"2023-11-07T16:49:27.716Z","dependency_job_id":"66a517f0-d98c-47cc-b2b0-4795af9d4bfa","html_url":"https://github.com/puppetlabs/puppetlabs-ntp","commit_stats":{"total_commits":740,"total_committers":171,"mean_commits":"4.3274853801169595","dds":0.8945945945945946,"last_synced_commit":"5e2f89e3eb4fc050bbe0f09095a01f5ab443e352"},"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puppetlabs%2Fpuppetlabs-ntp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puppetlabs%2Fpuppetlabs-ntp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puppetlabs%2Fpuppetlabs-ntp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/puppetlabs%2Fpuppetlabs-ntp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/puppetlabs","download_url":"https://codeload.github.com/puppetlabs/puppetlabs-ntp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254040638,"owners_count":22004585,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","module","supported"],"created_at":"2024-08-03T18:00:47.841Z","updated_at":"2025-05-13T23:05:11.409Z","avatar_url":"https://github.com/puppetlabs.png","language":"Ruby","funding_links":[],"categories":["Documentation"],"sub_categories":[],"readme":"# ntp\n\n#### Table of Contents\n\n\n1. [Module Description - What the module does and why it is useful](#module-description)\n1. [Setup - The basics of getting started with ntp](#setup)\n1. [Usage - Configuration options and additional functionality](#usage)\n1. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n1. [Limitations - OS compatibility, etc.](#limitations)\n1. [License](#license)\n1. [Development - Guide for contributing to the module](#development)\n\n\u003ca id=\"module-description\"\u003e\u003c/a\u003e\n## Module description\n\nThe ntp module installs, configures, and manages the NTP service across a range of operating systems and distributions.\n\n\u003ca id=\"setup\"\u003e\u003c/a\u003e\n## Setup\n\n### Beginning with ntp\n\n`include ntp` is enough to get you up and running. To pass in parameters specifying which servers to use:\n\n```puppet\nclass { 'ntp':\n  servers =\u003e [ 'ntp1.corp.com', 'ntp2.corp.com' ],\n}\n```\n\n\u003ca id=\"usage\"\u003e\u003c/a\u003e\n## Usage\n\nAll parameters for the ntp module are contained within the main `ntp` class, so for any function of the module, set the options you want. See the common usages below for examples.\n\n### Install and enable NTP\n\n```puppet\ninclude ntp\n```\n\n### Change NTP servers\n\n```puppet\nclass { 'ntp':\n  servers =\u003e [ 'ntp1.corp.com', 'ntp2.corp.com' ],\n}\n```\n\n### Restrict who can connect\n\n```puppet\nclass { 'ntp':\n  servers  =\u003e [ 'ntp1.corp.com', 'ntp2.corp.com' ],\n  restrict =\u003e ['127.0.0.1'],\n}\n```\n\n### Install a client that can't be queried\n\n```puppet\nclass { 'ntp':\n  servers   =\u003e ['ntp1.corp.com', 'ntp2.corp.com'],\n  restrict  =\u003e [\n    'default ignore',\n    '-6 default ignore',\n    '127.0.0.1',\n    '-6 ::1',\n    'ntp1.corp.com nomodify notrap nopeer noquery',\n    'ntp2.corp.com nomodify notrap nopeer noquery'\n  ],\n}\n```\n\n### Listen on specific interfaces\n\nRestricting NTP to a specific interface is especially useful on Openstack node, which may have numerous virtual interfaces.\n\n```puppet\nclass { 'ntp':\n  servers  =\u003e [ 'ntp1.corp.com', 'ntp2.corp.com' ],\n  interfaces =\u003e ['127.0.0.1', '1.2.3.4']\n}\n```\n\n### Opt out of Puppet controlling the service\n\n```puppet\nclass { 'ntp':\n  servers        =\u003e [ 'ntp1.corp.com', 'ntp2.corp.com' ],\n  restrict       =\u003e ['127.0.0.1'],\n  service_manage =\u003e false,\n}\n```\n\n### Configure and run ntp without installing\n\n```puppet\nclass { 'ntp':\n  package_manage =\u003e false,\n}\n```\n\n### Pass in a custom template\n\n```puppet\nclass { 'ntp':\n  servers         =\u003e [ 'ntp1.corp.com', 'ntp2.corp.com' ],\n  restrict        =\u003e ['127.0.0.1'],\n  service_manage  =\u003e false,\n  config_epp      =\u003e 'different/module/custom.template.epp',\n}\n```\n\n### Connect to an NTP server with the burst option enabled\n\n```puppet\nclass { 'ntp':\n  servers =\u003e [ 'ntp1.corp.com', 'ntp2.corp.com' ],\n  burst  =\u003e true,\n}\n```\n\n\u003ca id=\"reference\"\u003e\u003c/a\u003e\n## Reference\n\nSee [REFERENCE.md](https://github.com/puppetlabs/puppetlabs-ntp/blob/main/REFERENCE.md)\n\n\u003ca id=\"limitations\"\u003e\u003c/a\u003e\n## Limitations\n\nThis module has been tested on [all PE-supported platforms](https://forge.puppetlabs.com/supported#compat-matrix). Additionally, it is tested (but not supported) on Solaris 10 and Fedora 20-22.\n\nFor an extensive list of supported operating systems, see [metadata.json](https://github.com/puppetlabs/puppetlabs-ntp/blob/main/metadata.json)\n\n\u003ca id=\"license\"\u003e\u003c/a\u003e \n## License\n\nThis codebase is licensed under the Apache2.0 licensing, however due to the nature of the codebase the open source dependencies may also use a combination of [AGPL](https://opensource.org/license/agpl-v3/), [BSD-2](https://opensource.org/license/bsd-2-clause/), [BSD-3](https://opensource.org/license/bsd-3-clause/), [GPL2.0](https://opensource.org/license/gpl-2-0/), [LGPL](https://opensource.org/license/lgpl-3-0/), [MIT](https://opensource.org/license/mit/) and [MPL](https://opensource.org/license/mpl-2-0/) Licensing.\n\n\u003ca id=\"development\"\u003e\u003c/a\u003e \n## Development\n\nWe are experimenting with a new tool for running acceptance tests. It's name is [puppet_litmus](https://github.com/puppetlabs/puppet_litmus) this replaces beaker as the test runner. To run the acceptance tests follow the instructions [here](https://github.com/puppetlabs/puppet_litmus/wiki/Tutorial:-use-Litmus-to-execute-acceptance-tests-with-a-sample-module-(MoTD)#install-the-necessary-gems-for-the-module).\n\nPuppet modules on the Puppet Forge are open projects, and community contributions are essential for keeping them great. Please follow our guidelines when contributing changes.\n\nFor more information, see our [module contribution guide.](https://puppet.com/docs/puppet/latest/contributing.html)\n\n### Contributors\n\nTo see who's already involved, see the [list of contributors.](https://github.com/puppetlabs/puppetlabs-ntp/graphs/contributors)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpuppetlabs%2Fpuppetlabs-ntp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpuppetlabs%2Fpuppetlabs-ntp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpuppetlabs%2Fpuppetlabs-ntp/lists"}