pihole's Introduction

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.

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

pihole's People

Contributors

Stargazers

Watchers

pihole's Issues

pihole installer is run every time, also on no change in git checkout

When this role is ran the pihole installer script is always ran, even if the git checkout shows that no changes were made to the underlying code.
I believe that in this case the installer does not need to rerun.

PLAYBOOK: test.yml ***********************************************************************************************************************************************************************************************************************************************************************
3 plays in test.yml

PLAY [install pihole] ********************************************************************************************************************************************************************************************************************************************************************

TASK [Gathering Facts] *******************************************************************************************************************************************************************************************************************************************************************
task path: /root/ansible/test.yml:2
ok: [pihole]
META: ran handlers

TASK [zfuller.pihole : ensure git] *******************************************************************************************************************************************************************************************************************************************************
task path: /root/.ansible/roles/zfuller.pihole/tasks/main.yml:2
ok: [pihole] => {"changed": false, "msg": "Nothing to do", "rc": 0, "results": []}

TASK [zfuller.pihole : cloning pihole] ***************************************************************************************************************************************************************************************************************************************************
task path: /root/.ansible/roles/zfuller.pihole/tasks/main.yml:7
ok: [pihole] => {"after": "6b536b7428a1f57ff34ddc444ded6d3a62b00a38", "before": "6b536b7428a1f57ff34ddc444ded6d3a62b00a38", "changed": false, "remote_url_changed": false}

TASK [zfuller.pihole : making directories] ***********************************************************************************************************************************************************************************************************************************************
task path: /root/.ansible/roles/zfuller.pihole/tasks/main.yml:14
changed: [pihole] => {"changed": true, "gid": 993, "group": "pihole", "mode": "0755", "owner": "pihole", "path": "/etc/pihole/", "size": 4096, "state": "directory", "uid": 996}

TASK [zfuller.pihole : pushing config file setupVars] ************************************************************************************************************************************************************************************************************************************
task path: /root/.ansible/roles/zfuller.pihole/tasks/main.yml:20
changed: [pihole] => {"changed": true, "checksum": "9f9ef421e2b722483eed2508ed0ba728ee3e4b2d", "dest": "/etc/pihole/setupVars.conf", "gid": 0, "group": "root", "md5sum": "1f513a80dfd73207dca9d39168736804", "mode": "0644", "owner": "root", "size": 506, "src": "/root/.ansible/tmp/ansible-tmp-1601211093.2265966-23363-209798326403475/source", "state": "file", "uid": 0}

TASK [zfuller.pihole : installing pihole] ************************************************************************************************************************************************************************************************************************************************
task path: /root/.ansible/roles/zfuller.pihole/tasks/main.yml:26
changed: [pihole] => {"changed": true, "cmd": "bash basic-install.sh --unattended ", "delta": "0:01:40.522066", "end": "2020-09-27 12:53:14.707935", "rc": 0, "start": "2020-09-27 12:51:34.185869", "stderr": "", "stderr_lines": [], "stdout": "\n  [✓] Root user check\n\n        .;;,.\n        .ccccc:,.\n         :cccclll:.      ..,,\n          :ccccclll.   ;ooodc\n           'ccll:;ll .oooodc\n             .;cll.;;looo:.\n                 .. ','.\n                .',,,,,,'.\n              .',,,,,,,,,,.\n            .',,,,,,,,,,,,....\n          ....''',,,,,,,'.......\n        .........  ....  .........\n        ..........      ..........\n        ..........      ..........\n        .........  ....  .........\n          ........,,,,,,,'......\n            ....',,,,,,,,,,,,.\n               .',,,,,,,,,'.\n 
<snip>

Recommend Projects