{"id":15013996,"url":"https://github.com/bodgit/puppet-nut","last_synced_at":"2025-10-09T16:09:43.228Z","repository":{"id":54156672,"uuid":"41641865","full_name":"bodgit/puppet-nut","owner":"bodgit","description":"Puppet Module for Network UPS Tools (NUT)","archived":false,"fork":false,"pushed_at":"2023-08-03T16:45:55.000Z","size":210,"stargazers_count":1,"open_issues_count":3,"forks_count":8,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-09-14T10:17:41.788Z","etag":null,"topics":["nut","puppet"],"latest_commit_sha":null,"homepage":"https://forge.puppetlabs.com/bodgit/nut","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/bodgit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-08-30T20:21:40.000Z","updated_at":"2021-03-06T22:07:50.000Z","dependencies_parsed_at":"2024-09-20T15:32:19.331Z","dependency_job_id":null,"html_url":"https://github.com/bodgit/puppet-nut","commit_stats":{"total_commits":40,"total_committers":3,"mean_commits":"13.333333333333334","dds":0.09999999999999998,"last_synced_commit":"ef986762784c71e0c5c9a83d2ccefc1b68106a18"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/bodgit/puppet-nut","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-nut","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-nut/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-nut/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-nut/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bodgit","download_url":"https://codeload.github.com/bodgit/puppet-nut/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bodgit%2Fpuppet-nut/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001762,"owners_count":26083171,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["nut","puppet"],"created_at":"2024-09-24T19:45:02.782Z","updated_at":"2025-10-09T16:09:43.212Z","avatar_url":"https://github.com/bodgit.png","language":"Ruby","readme":"# nut\n\n[![Build Status](https://travis-ci.org/bodgit/puppet-nut.svg?branch=master)](https://travis-ci.org/bodgit/puppet-nut)\n[![Codecov](https://img.shields.io/codecov/c/github/bodgit/puppet-nut)](https://codecov.io/gh/bodgit/puppet-nut)\n[![Puppet Forge version](http://img.shields.io/puppetforge/v/bodgit/nut)](https://forge.puppetlabs.com/bodgit/nut)\n[![Puppet Forge downloads](https://img.shields.io/puppetforge/dt/bodgit/nut)](https://forge.puppetlabs.com/bodgit/nut)\n[![Puppet Forge - PDK version](https://img.shields.io/puppetforge/pdk-version/bodgit/nut)](https://forge.puppetlabs.com/bodgit/nut)\n\n#### Table of Contents\n\n1. [Description](#description)\n2. [Setup - The basics of getting started with nut](#setup)\n    * [What nut affects](#what-nut-affects)\n    * [Setup requirements](#setup-requirements)\n    * [Beginning with nut](#beginning-with-nut)\n3. [Usage - Configuration options and additional functionality](#usage)\n4. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n5. [Limitations - OS compatibility, etc.](#limitations)\n6. [Development - Guide for contributing to the module](#development)\n\n## Description\n\nThis module ensures that the Network UPS Tools (NUT) are installed and\nconfigured.\n\nRHEL/CentOS, Ubuntu, Debian and OpenBSD are supported using Puppet 5 or\nlater.\n\n## Setup\n\n### What nut affects\n\nThis module will potentially configure your host to respond to power failures.\n\n### Setup Requirements\n\nOn RHEL/CentOS platforms you will need to have access to the EPEL repository by\nusing [stahnma/epel](https://forge.puppet.com/stahnma/epel) or by other means.\n\n### Beginning with nut\n\nIn the very simplest case, you can just include the following:\n\n```puppet\ninclude ::nut\n```\n\n## Usage\n\nThe above example is not terribly useful as it does not include any UPS\ndevices, so it should be extended to something like the following:\n\n```puppet\ninclude ::nut\n::nut::ups { 'sua1000i':\n  driver =\u003e 'usbhid-ups',\n  port   =\u003e 'auto',\n}\n::nut::user { 'local':\n  password =\u003e 'password',\n  upsmon   =\u003e 'master',\n}\n::nut::user { 'remote':\n  password =\u003e 'password',\n  upsmon   =\u003e 'slave',\n}\n::nut::client::ups { 'sua1000i@localhost':\n  user     =\u003e 'local',\n  password =\u003e 'password',\n}\n```\n\nIf the host does not have any UPS device directly attached, but is powered by\none which is controlled by another host such as the one above, use the\nfollowing:\n\n```puppet\ninclude ::nut:client\n::nut::client::ups { 'sua1000i@remotehost':\n  user     =\u003e 'remote',\n  password =\u003e 'password',\n}\n```\n\n## Reference\n\nThe reference documentation is generated with\n[puppet-strings](https://github.com/puppetlabs/puppet-strings) and the latest\nversion of the documentation is hosted at\n[https://bodgit.github.io/puppet-nut/](https://bodgit.github.io/puppet-nut/)\nand available also in the [REFERENCE.md](https://github.com/bodgit/puppet-nut/blob/master/REFERENCE.md).\n\n## Limitations\n\nThis module has been built on and tested against Puppet 5 and higher.\n\nThe module has been tested on:\n\n* RedHat Enterprise Linux 6/7\n* Ubuntu 14.04/16.04\n* Debian 8\n* OpenBSD 6.0\n\n## Development\n\nThe module relies on [PDK](https://puppet.com/docs/pdk/1.x/pdk.html) and has\nboth [rspec-puppet](http://rspec-puppet.com) and\n[beaker-rspec](https://github.com/puppetlabs/beaker-rspec) tests. Run them\nwith:\n\n```\n$ bundle exec rake spec\n$ PUPPET_INSTALL_TYPE=agent PUPPET_INSTALL_VERSION=x.y.z bundle exec rake beaker:\u003cnodeset\u003e\n```\n\nPlease log issues or pull requests at\n[github](https://github.com/bodgit/puppet-nut).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbodgit%2Fpuppet-nut","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbodgit%2Fpuppet-nut","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbodgit%2Fpuppet-nut/lists"}