{"id":15517051,"url":"https://github.com/deric/puppet-htop","last_synced_at":"2026-01-24T22:05:44.726Z","repository":{"id":57664411,"uuid":"71017890","full_name":"deric/puppet-htop","owner":"deric","description":"Htop configuration - the ultimate missing module in Puppet world","archived":false,"fork":false,"pushed_at":"2024-06-21T18:20:21.000Z","size":135,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-24T22:15:17.347Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/deric.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-10-15T22:52:05.000Z","updated_at":"2024-06-21T18:19:25.000Z","dependencies_parsed_at":"2023-12-18T13:59:42.053Z","dependency_job_id":"3dcf9fcc-05fc-4cc4-a3e5-8d2694403822","html_url":"https://github.com/deric/puppet-htop","commit_stats":{"total_commits":33,"total_committers":1,"mean_commits":33.0,"dds":0.0,"last_synced_commit":"40d1b71d1519b01b7acf23143a43a0888f40e52a"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deric%2Fpuppet-htop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deric%2Fpuppet-htop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deric%2Fpuppet-htop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deric%2Fpuppet-htop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deric","download_url":"https://codeload.github.com/deric/puppet-htop/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254219374,"owners_count":22034397,"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":[],"created_at":"2024-10-02T10:11:02.926Z","updated_at":"2026-01-24T22:05:39.707Z","avatar_url":"https://github.com/deric.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# puppet-htop\n\n[![Puppet\nForge](http://img.shields.io/puppetforge/v/deric/htop.svg)](https://forge.puppetlabs.com/deric/htop) [![Tests](https://github.com/deric/puppet-htop/actions/workflows/tests.yaml/badge.svg)](https://github.com/deric/puppet-htop/actions/workflows/tests.yaml) [![Puppet Forge\nDownloads](http://img.shields.io/puppetforge/dt/deric/htop.svg)](https://forge.puppetlabs.com/deric/htop/scores)\n\nManages [htop](https://github.com/htop-dev/htop) package and its configuration with Hiera support (optional).\n\n## Usage\n\nBasic definition will install `htop` package and create `/root/.config/htop/htoprc` file:\n```puppet\ninclude htop\n```\n\nSince htop 3, you can configure screens:\n\n```yaml\nhtop::users:\n  john:\n    options:\n      config_reader_min_version: 3\n    screens:\n      - name: 'Main'\n        header: 'PID USER PRIORITY NICE M_VIRT M_RESIDENT M_SHARE STATE PERCENT_CPU PERCENT_MEM TIME Command'\n        config:\n          sort_key: PERCENT_MEM\n```\nnote, the config should include `config_reader_min_version=3`.\n\nIn most cases you probably want to override just some configuration\n```yaml\nhtop::users:\n  root:\n    options:\n      sort_key: 47 # memory\n      highlight_base_name: 1\n```\n\nBut you can also change global settings (applies to multiple accounts) e.g. via Hiera:\n```yaml\nhtop::defaults:\n  sort_key: 47 # sort by memory\n  highlight_base_name: 1\n```\nyou can configure different options for each account:\n\n```yaml\nhtop::users:\n  foo:\n    options:\n      hide_kernel_threads: 0\n  bar:\n    options:\n      tree_view: 1\n```\nuser `options` will be merged into global defauls (defined in `htop::config::defaults`).\n\nor directly via puppet code:\n```puppet\nclass{'htop':\n  defaults =\u003e {\n    sort_key =\u003e 46,\n  }\n}\n```\nAll Puppet variables are documented in [REFERENCE.md](./REFERENCE.md).\n\n## Installation\n\nPreferably using libarian or r10k:\n```ruby\nmod 'deric-htop'\n```\n\n## Requirements\n\n  * Puppet \u003e= 7\n  * Ruby 2.7 and newer\n\n## Dependencies\n\n  * `puppetlabs-stdlib` - `\u003e= 2.5.0`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderic%2Fpuppet-htop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fderic%2Fpuppet-htop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fderic%2Fpuppet-htop/lists"}