History

Claudio Maradonna a373a6dac4 update README pi-hole role		2022-11-21 17:40:47 +01:00
..
defaults	updating some roles with README	2022-11-21 16:52:36 +01:00
handlers	init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates	2022-11-18 18:33:37 +01:00
meta	init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates	2022-11-18 18:33:37 +01:00
tasks	updating some roles with README	2022-11-21 16:52:36 +01:00
tests	init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates	2022-11-18 18:33:37 +01:00
vars	init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates	2022-11-18 18:33:37 +01:00
.travis.yml	init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates	2022-11-18 18:33:37 +01:00
README.md	update README pi-hole role	2022-11-21 17:40:47 +01:00

README.md

pi-hole

This role setup minimal requirements for pi-hole setup but actually cannot install pi-hole for you. In addition setup firewall for you; can install custom list directly in the Database or update DNS Database List

Requirements

Role Variables

pihole_enabled (boolean): Enable or disable pi-hole support pihole_install_custom_list (boolean): If true will install custom list into the pi-hole database pihole_update_gravity (boolean): If true the dns database will be updated

pihole_custom_list (array): Array of URLs that can be installed as DNS lists. Actually doesn't clean old lists before install!

Dependencies

Example Playbook

ansible-playbook -i inventory/example.yml pi-hole.yml --extra-vars="target=example_target"

License

GPLv3

Author Information

Claudio Maradonna