pihole
pihole raspberry pi ansible role
Role installs and configures Pihole https://pi-hole.net/ with unattentded setup
Documents relating to pi-hole are at https://docs.pi-hole.net/
Requirements
User with sudo access to the machine.
other prerequisites
Required Variables
pihole_setupvars_webpassword
You will need to generate a admin password for the pihole_setupvars_webpassword
variable, password is hashed with sha256 twice. You can genearte a password with the following shell command.
With the password in a file (recommended).
echo -n $(cat ~/piholepass.word) | sha256sum | awk '{printf "%s", $1}' | sha256sum
With the password in shell command (not recommended)
echo -n notsosecretpassword | sha256sum | awk '{printf "%s", $1}' | sha256sum
recommended to store this variable in ansible vault.
pihole_setupvars_ipv4_address
IPv4 adress of the pihole
pihole_setupvars_pihole_dns_1/2
DNS servers you want the pihole to use
DNS
Alternative DNS Providers
Google: https://developers.google.com/speed/public-dns
- 8.8.8.8
- 8.8.4.4
OpenDNS: https://use.opendns.com/
- 208.67.222.222
- 208.67.220.220
Cloudflare: https://1.1.1.1/dns/
- 1.1.1.1
- 1.0.0.1
Role Variables
defaults/main.yml for default values
Example Playbook
---
- name: pihole
hosts: pi
strategy: free
become_method: sudo
become: yes
gather_facts: yes
vars:
pihole_setupvars_ipv4_address: 192.168.1.100
pihole_setupvars_webpassword: 35030714f1136486a612d7014b739a6c7ef3be589bb14b14a3d01f521dd7ef18
pihole_setupvars_pihole_dns_1: 1.1.1.1
pihole_setupvars_pihole_dns_2: 1.0.0.1
roles:
- zfuller.pihole
Install
ansible-galaxy install zfuller/pihole
License
Unknown
Downloads
262
Owner
DevOps Engineer