{"id":20811299,"url":"https://github.com/express42/theforeman","last_synced_at":"2025-07-09T15:39:19.323Z","repository":{"id":35454280,"uuid":"39721474","full_name":"express42/theforeman","owner":"express42","description":"Express 42 theforeman cookbook","archived":false,"fork":false,"pushed_at":"2016-02-12T16:09:16.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":23,"default_branch":"master","last_synced_at":"2025-01-18T14:46:32.262Z","etag":null,"topics":["chef","cookbooks"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/express42.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-26T10:13:00.000Z","updated_at":"2024-05-11T21:17:21.000Z","dependencies_parsed_at":"2022-09-07T06:11:44.108Z","dependency_job_id":null,"html_url":"https://github.com/express42/theforeman","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/express42%2Ftheforeman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/express42%2Ftheforeman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/express42%2Ftheforeman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/express42%2Ftheforeman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/express42","download_url":"https://codeload.github.com/express42/theforeman/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243158972,"owners_count":20245669,"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":["chef","cookbooks"],"created_at":"2024-11-17T20:39:57.664Z","updated_at":"2025-03-12T04:43:26.453Z","avatar_url":"https://github.com/express42.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Description\n\nInstalls/Configures theforeman\n\n# Requirements\n\n## Platform:\n\n*No platforms defined*\n\n## Cookbooks:\n\n* postgresql_lwrp\n* memcached\n* nginx\n\n# Attributes\n\n* `node['foreman']['etc_default']['start']` -  Defaults to `yes`.\n* `node['foreman']['user']` -  Defaults to `foreman`.\n* `node['foreman']['share_path']` -  Defaults to `/usr/share/foreman`.\n* `node['foreman']['foreman_conf_path']` -  Defaults to `/etc/foreman`.\n* `node['foreman']['foreman_proxy_conf_path']` -  Defaults to `/etc/foreman-proxy`.\n* `node['foreman']['foreman-proxy']['dhcp']['config']['enabled']` -  Defaults to `true`.\n* `node['foreman']['foreman-proxy']['dhcp']['config']['dhcp_vendor']` -  Defaults to `isc`.\n* `node['foreman']['foreman-proxy']['dhcp']['config']['dhcp_config']` -  Defaults to `/etc/dhcp/dhcpd.conf`.\n* `node['foreman']['foreman-proxy']['dhcp']['config']['dhcp_leases']` -  Defaults to `/var/lib/dhcp/dhcpd.leases`.\n* `node['foreman']['plugins']['memcache']['config']['memcache']['hosts']` -  Defaults to `[ ... ]`.\n* `node['foreman']['plugins']['memcache']['config']['memcache']['options']['namespace']` -  Defaults to `foreman`.\n* `node['foreman']['plugins']['memcache']['config']['memcache']['options']['expires_in']` -  Defaults to `86400`.\n* `node['foreman']['foreman-proxy']['tftp']['tftproot']` -  Defaults to `/srv/tftp`.\n\n# Recipes\n\n* theforeman::config\n* theforeman::database\n* theforeman::default\n* theforeman::dhcp\n* theforeman::install\n* theforeman::memcache\n* theforeman::official_repository\n* theforeman::old\n* theforeman::tftp\n\n# HOW-TO\n\nSetup foreman and foreman-proxy:\n```\ncd /usr/share/foreman\nRAILS_ENV=production foreman-rake db:migrate\nRAILS_ENV=production foreman-rake db:seed\nvi /etc/foreman/settings.yaml\nvi /etc/foreman/plugins/foreman_memcache.yaml\napt-get install ruby-foreman-chef\n/etc/init.d/foreman restart\nvi /etc/foreman-proxy/settings.yml\nvi /etc/foreman-proxy/settings.d/bmc.yml\nvi /etc/foreman-proxy/settings.d/chef.yml\nvi /etc/foreman-proxy/settings.d/dhcp.yml\nvi /etc/foreman-proxy/settings.d/discovery.yml\nvi /etc/foreman-proxy/settings.d/facts.yml\nvi /etc/foreman-proxy/settings.d/puppetca.yml\nvi /etc/foreman-proxy/settings.d/templates.yml\nvi /etc/foreman-proxy/settings.d/tftp.yml\n/etc/init.d/foreman-proxy restart\n```\n\nSetup dhcp server:\n```\nvi /etc/dhcp/dhcpd.conf\n/etc/init.d/isc-dhcp-server restart\n```\n\nSetup tftp server:\n```\napt-get install inetutils-inetd\nvi /etc/inetd.conf\n/etc/init.d/inetutils-inetd start\n```\n\nReset admin password:\n```\nRAILS_ENV=production foreman-rake permissions:reset\n```\n\nLibvirt auth:\n```\nmkdir /etc/foreman/libvirt-pki\nvi cacert.pem\nvi clientcert.pem\nvi clientkey.pem\n```\n\nChef Handler:\n```\nnode.default['chef_client']['load_gems']['chef_handler_foreman']['require_name'] = 'chef_handler_foreman'\nnode.default['foreman']['server_url'] = 'http://'\n\ntemplate '/etc/chef/client.d/foreman_handler.rb' do\n  source 'foreman_handler.rb.erb'\n  mode '0644'\n  notifies :create, 'ruby_block[reload_client_config]'\n  variables(\n    server_url: node['foreman']['server_url']\n  )\nend\n\nforeman_server_options  url: '\u003c%= @server_url %\u003e'\nforeman_facts_upload    true\nforeman_reports_upload  true\nreports_log_level       \"notice\"\n```\n\n# License and Maintainer\n\nMaintainer:: LLC Express 42 (\u003ccookbooks@express42.com\u003e)\n\nLicense:: MIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpress42%2Ftheforeman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexpress42%2Ftheforeman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpress42%2Ftheforeman/lists"}