Pi-hole

Role to deploy and configures everything required to run Pi-hole on a Raspberry Pi in your network.

Requirements

• Ansible 2.9 or newer

Role Variables

variable name	default	description
raspberry_user	pi	The user that will be running Pi-hole.
dns_server1	8.8.8.8	The IP for the primary DNS server Pi-hole will forward requests to.
dns_server2	8.8.4.4	The IP for the secondary DNS server Pi-hole will forward request to if the primary DNS server is not available. Use the value "no" to disable the secondary DNS
pihole_admin_password	random	Administrator password for the web ui for Pi-hole. It is recommended that you set this to something else, or you will have to dig through the logs on the host to find the automatically generated password.

Dependencies

• geerlingguy.docker
• geerlingguy.pip

How to use

First install the role on your management node / local machine, which should download all the required dependencies.

ansible-galaxy install twinsnes.pihole

Then either add the role with required configuration to your playbook for your Pi, or make a new one like the one below.

Playbook file:

- hosts: all
  roles:
  - name: twinsnes.pihole
    vars:
      pihole_admin_password: "SomeSecretPassword"

Using an inventory file makes it a lot easier to manage hosts and will alow you to store configuration for your host in a file for later. So when you need to run this again in 6 months, you don't have to remember the settings.

Inventory file:

all:
  vars:
    ansible_connection: ssh
    ansible_ssh_user: pi
    ansible_ssh_pass: raspberry
  hosts:
    raspberry:
      ansible_host: "192.168.1.100"

Once you have both your playbook and your inventory file set up. Execute your playbook

ansible-playbook playbook.yaml -i inventory.yaml

License

Apache-2.0