History

Claudio Maradonna 082d6ed47e better pihole role; change update_only and uninstall from variable to global tag; update accordingly dependent roles		2023-01-11 17:44:16 +01:00
..
defaults	add COPYING; add missing README informations	2022-11-23 15:10:28 +01:00
handlers	init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates	2022-11-18 18:33:37 +01:00
meta	better pihole role; change update_only and uninstall from variable to global tag; update accordingly dependent roles	2023-01-11 17:44:16 +01:00
tasks	better pihole role; change update_only and uninstall from variable to global tag; update accordingly dependent roles	2023-01-11 17:44:16 +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	better pihole role; change update_only and uninstall from variable to global tag; update accordingly dependent roles	2023-01-11 17:44:16 +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_custom_list (array): Array of URLs that can be installed as DNS lists. Actually doesn't clean old lists before install!
pihole_install_custom_list: If present will install custom list into the pi-hole database

Role Tags

global.update_only: pihole -up
pihole.update_gravity: If present the dns database will be updated (pihole updateGravity)

Dependencies

curl
sqlite3 required by pihole.install_custom_list

Example Playbook

ansible-playbook -i inventory/example.yml handbook.yml --extra-vars="target=example_target" --tags dns_filter

License

GPLv3

Author Information

Claudio Maradonna