2022-11-21 17:40:47 +01:00
pi-hole
2022-11-18 18:33:37 +01:00
=========
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
2022-11-18 18:33:37 +01:00
Requirements
------------
2022-11-21 17:40:47 +01:00
.
2022-11-18 18:33:37 +01:00
Role Variables
--------------
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!**
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`)
2022-11-18 18:33:37 +01:00
Dependencies
------------
2023-01-11 17:44:16 +01:00
- curl
- sqlite3 required by `pihole.install_custom_list`
2022-11-18 18:33:37 +01:00
Example Playbook
----------------
2023-01-11 17:44:16 +01:00
`ansible-playbook -i inventory/example.yml handbook.yml --extra-vars="target=example_target" --tags dns_filter`
2022-11-18 18:33:37 +01:00
License
-------
2022-11-21 17:40:47 +01:00
GPLv3
2022-11-18 18:33:37 +01:00
Author Information
------------------
2022-11-21 17:40:47 +01:00
- [Claudio Maradonna ](https://social.unitoo.it/claudio )
