configurations-ansible/roles/pi-hole/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](https://social.unitoo.it/claudio)
update README pi-hole role 2022-11-21 17:40:47 +01:00			`pi-hole`
init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates 2022-11-18 18:33:37 +01:00			`=========`

update README pi-hole role 2022-11-21 17:40:47 +01:00			`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`
init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates 2022-11-18 18:33:37 +01:00
			`Requirements`
			`------------`

update README pi-hole role 2022-11-21 17:40:47 +01:00			`.`
init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates 2022-11-18 18:33:37 +01:00
			`Role Variables`
			`--------------`

fix typo inside multiple README; update last READMEs; update yggdrasil task to explicit uninstall yggdrasil with var 2022-11-21 17:54:00 +01:00			`- pihole_custom_list (array): Array of URLs that can be installed as DNS lists. Actually doesn't clean old lists before install!`
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			`- 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`)
init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates 2022-11-18 18:33:37 +01:00
			`Dependencies`
			`------------`

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			`- curl`
			- sqlite3 required by `pihole.install_custom_list`
init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates 2022-11-18 18:33:37 +01:00
			`Example Playbook`
			`----------------`

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			`ansible-playbook -i inventory/example.yml handbook.yml --extra-vars="target=example_target" --tags dns_filter`
init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates 2022-11-18 18:33:37 +01:00
			`License`
			`-------`

update README pi-hole role 2022-11-21 17:40:47 +01:00			`GPLv3`
init repo with: iptables, pihole, snort, yggdrasil, basic hardening, os-updates 2022-11-18 18:33:37 +01:00
			`Author Information`
			`------------------`

update README pi-hole role 2022-11-21 17:40:47 +01:00			`- [Claudio Maradonna](https://social.unitoo.it/claudio)`