Pi-hole

This guide explains how to set up and configure Pi-hole on a Raspberry Pi in your network.

Requirements

• Ansible version 2.9 or newer

Role Variables

Dependencies

• geerlingguy.docker
• geerlingguy.pip

How to Use

1. First, install the role on your management node or local machine to get all the necessary dependencies:

   ansible-galaxy install twinsnes.pihole
   

2. Add the role to your playbook with the required settings for your Pi, or create a new one like this example:

   Playbook file:

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

3. Using an inventory file can make it easier to manage different hosts and keep their settings saved for future use. This way, when you need to run it again in several months, you won’t have to remember the configurations.

   Inventory file:

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

4. After setting up both your playbook and inventory file, run your playbook:

   ansible-playbook playbook.yaml -i inventory.yaml
   

License

Apache-2.0