{"id":19249239,"url":"https://github.com/sous-chefs/foreman","last_synced_at":"2026-05-06T12:02:27.850Z","repository":{"id":11643488,"uuid":"14148325","full_name":"sous-chefs/foreman","owner":"sous-chefs","description":"Development repository for the foreman cookbook","archived":false,"fork":false,"pushed_at":"2026-05-05T09:38:13.000Z","size":337,"stargazers_count":9,"open_issues_count":7,"forks_count":5,"subscribers_count":17,"default_branch":"main","last_synced_at":"2026-05-05T11:14:06.103Z","etag":null,"topics":["chef","chef-cookbook","chef-resource","foreman","hacktoberfest","managed-by-terraform"],"latest_commit_sha":null,"homepage":"https://supermarket.chef.io/cookbooks/foreman","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sous-chefs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"open_collective":"sous-chefs"}},"created_at":"2013-11-05T17:17:29.000Z","updated_at":"2026-04-21T08:48:05.000Z","dependencies_parsed_at":"2023-09-24T06:58:49.520Z","dependency_job_id":"423fa484-2cd3-4baa-910e-bf1adc7b6401","html_url":"https://github.com/sous-chefs/foreman","commit_stats":{"total_commits":159,"total_committers":13,"mean_commits":12.23076923076923,"dds":0.7358490566037736,"last_synced_commit":"05bf14b251753894a78a9b2a4cc49e6ee63fd78c"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/sous-chefs/foreman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sous-chefs%2Fforeman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sous-chefs%2Fforeman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sous-chefs%2Fforeman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sous-chefs%2Fforeman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sous-chefs","download_url":"https://codeload.github.com/sous-chefs/foreman/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sous-chefs%2Fforeman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32692774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["chef","chef-cookbook","chef-resource","foreman","hacktoberfest","managed-by-terraform"],"created_at":"2024-11-09T18:13:24.108Z","updated_at":"2026-05-06T12:02:27.845Z","avatar_url":"https://github.com/sous-chefs.png","language":"Ruby","funding_links":["https://opencollective.com/sous-chefs"],"categories":[],"sub_categories":[],"readme":"# Foreman cookbook\n\n[![Cookbook Version](https://img.shields.io/cookbook/v/foreman.svg)](https://supermarket.chef.io/cookbooks/foreman)\n[![CI State](https://github.com/sous-chefs/foreman/actions/workflows/ci.yml/badge.svg)](https://github.com/sous-chefs/foreman/actions/workflows/ci.yml)\n\nThis cookbook now exposes custom resources for installing and configuring Foreman and Foreman Smart Proxy. The legacy `recipes/` and `attributes/` APIs were removed as part of the migration.\n\n* Migration notes: [migration.md](migration.md)\n* Platform and package constraints: [LIMITATIONS.md](LIMITATIONS.md)\n\n## Resources\n\n* `foreman_app`\n  Installs Foreman, renders application configuration, optionally prepares the database, and manages the `foreman` service.\n* `foreman_proxy`\n  Installs Smart Proxy, renders `settings.yml` and module fragments, optionally configures DNS/DHCP/TFTP helpers, and manages the `foreman-proxy` service.\n* `foreman_repo`\n  Configures the official Foreman APT repositories.\n* `foreman_plugins`\n  Installs Foreman or Smart Proxy plugin packages.\n* `foreman_rake`\n  Runs `foreman-rake` tasks.\n* `foreman_smartproxy`\n  Registers or removes a Smart Proxy through the Foreman API.\n* `foreman_proxy_settings_file`\n  Renders a module file under `/etc/foreman-proxy/settings.d/`.\n\n## Supported platforms\n\n* Debian 12\n* Ubuntu 22.04\n\nThese limits are based on the current upstream package documentation summarized in [LIMITATIONS.md](LIMITATIONS.md).\n\n## Usage\n\n### Foreman server\n\n```ruby\nforeman_app 'default' do\n  server_name 'foreman.example'\n  database(\n    adapter: 'postgresql',\n    host: '127.0.0.1',\n    username: 'foreman',\n    password: 'super-secret'\n  )\nend\n\nforeman_plugins 'server-plugins' do\n  packages %w[foreman-libvirt ruby-foreman-chef]\nend\n```\n\n### Foreman Smart Proxy\n\n```ruby\nforeman_proxy 'default' do\n  server_name 'foreman.example'\n  register false\n  dns(\n    enabled: true,\n    managed: true,\n    interface: 'eth0'\n  )\n  dhcp(\n    enabled: true,\n    managed: true,\n    interface: 'eth0',\n    range: '10.0.0.10 10.0.0.20'\n  )\n  tftp(\n    enabled: true\n  )\nend\n```\n\n## Testing\n\n* `cookstyle`\n* `chef exec rspec --format documentation`\n* `yamllint .`\n* `markdownlint-cli2 \"**/*.md\"`\n* `KITCHEN_LOCAL_YAML=kitchen.dokken.yml chef exec kitchen test default-ubuntu-2204 --destroy=always`\n* `KITCHEN_LOCAL_YAML=kitchen.dokken.yml chef exec kitchen test proxy-debian-12 --destroy=always`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsous-chefs%2Fforeman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsous-chefs%2Fforeman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsous-chefs%2Fforeman/lists"}