summaryrefslogtreecommitdiffstats
path: root/roles/pihole/meta
diff options
context:
space:
mode:
authorAhmed Abdelhalim <[email protected]>2025-08-11 21:50:28 +0200
committerAhmed Abdelhalim <[email protected]>2025-08-11 23:28:42 +0200
commit8f539a76effcfb794145905736106de9e7f6aa8d (patch)
tree2538bb504082370f3d14da549b6a5e7e6f5ad487 /roles/pihole/meta
parentbed8aaaeb0b63b2072fbd030d76f8f928432e7b8 (diff)
Add pihole role to configure raspberry pi
Diffstat (limited to 'roles/pihole/meta')
-rw-r--r--roles/pihole/meta/argument_specs.yml36
-rw-r--r--roles/pihole/meta/main.yml16
2 files changed, 52 insertions, 0 deletions
diff --git a/roles/pihole/meta/argument_specs.yml b/roles/pihole/meta/argument_specs.yml
new file mode 100644
index 00000000..b50fc5c5
--- /dev/null
+++ b/roles/pihole/meta/argument_specs.yml
@@ -0,0 +1,36 @@
+---
+argument_specs:
+ main:
+ options:
+ pihole_password:
+ type: "str"
+ description: "The pi-hole web-server plain text password (double sha265 hashed) default: changeme"
+ default: "{{ ('changeme' | hash('sha256') | hash('sha256'))[:64] }}"
+ pihole_totp_secret:
+ type: "str"
+ description: "The pi-hole TOTP 2FA secret"
+ default: "CHANGEME"
+ pihole_dns:
+ type: "list"
+ description: "The list of DNS servers to use as upstreams"
+ elements: "str"
+ default:
+ - "9.9.9.9" # Quad9
+ - "1.1.1.1" # Cloudflare
+ - "8.8.8.8" # Google
+ pihole_interface:
+ type: "str"
+ description: "The interface to bind the pi-hole on"
+ default: "{{ ansible_default_ipv4.interface }}"
+ pihole_dns_blocking_enabled:
+ type: "bool"
+ description: "The boolean flag to toggle DNS blocking"
+ default: true
+ pihole_dhcp_enabled:
+ type: "bool"
+ description: "The boolean flag to toggle DHCP on the pi-hole"
+ default: false
+ pihole_domain:
+ type: "str"
+ description: "The domain name to be configured when the pi is exposed over the internet"
+ default: ""
diff --git a/roles/pihole/meta/main.yml b/roles/pihole/meta/main.yml
new file mode 100644
index 00000000..8b21005e
--- /dev/null
+++ b/roles/pihole/meta/main.yml
@@ -0,0 +1,16 @@
+---
+dependencies: []
+galaxy_info:
+ role_name: pihole
+ author: a14m
+ description: "Configure pihole on supported devices"
+ company: "kartoffeln.work GmbH."
+ license: "license MIT"
+ min_ansible_version: "2.18"
+ platforms:
+ - name: Ubuntu
+ versions:
+ - noble
+ - name: Debian
+ versions:
+ - bookworm