configurations-ansible/roles/pi-hole/README.md

39 lines
952 B
Markdown
Raw Normal View History

2022-11-21 17:40:47 +01:00
pi-hole
=========
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
Requirements
------------
2022-11-21 17:40:47 +01:00
.
Role Variables
--------------
2022-11-21 17:40:47 +01:00
**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
------------
2022-11-21 17:40:47 +01:00
.
Example Playbook
----------------
2022-11-21 17:40:47 +01:00
`ansible-playbook -i inventory/example.yml pi-hole.yml --extra-vars="target=example_target"`
License
-------
2022-11-21 17:40:47 +01:00
GPLv3
Author Information
------------------
2022-11-21 17:40:47 +01:00
- [Claudio Maradonna](https://social.unitoo.it/claudio)