theforeman / smart_proxy_dhcp_dnsmasq

dnsmasq DHCP plugin for Foreman smart-proxy
GNU General Public License v3.0
7 stars 7 forks source link
dhcp-provider dnsmasq hacktoberfest smart-proxy theforeman

Dnsmasq DHCP Smart Proxy plugin

This plugin adds a new DHCP provider for managing records in dnsmasq.

Installation

See How_to_Install_a_Smart-Proxy_Plugin for how to install Smart Proxy plugins

This plugin is compatible with Smart Proxy 1.17 or higher.

You need to add two lines to your dnsmasq configuration to use this plugin;

dhcp-optsfile=<target_dir>/dhcpopts.conf
dhcp-hostsfile=<target_dir>/dhcphosts

Dnsmasq will also require write privileges to the configuration file and folder specified.

Configuration

To enable this DNS provider, edit /etc/foreman-proxy/settings.d/dhcp.yml and set:

:use_provider: dhcp_dnsmasq

Configuration options for this plugin are in /etc/foreman-proxy/settings.d/dhcp_dnsmasq.yml and include:

For best results, the write config should point to a file in a dnsmasq conf-dir which only the smart-proxy uses.

Contributing

Fork and send a Pull Request. Thanks!

Copyright

Copyright (c) 2017 Alexander Olofsson

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.