feat: initial installation role for pihole

README.md

@@ -0,0 +1,41 @@
+# ansible-role-pihole
+
+Installs Pi-hole using the official unattended installer. A `setupVars.conf`
+is written before the installer runs so no interactive prompts appear.
+
+The installer creates its own system users and manages its own services.
+
+## Requirements
+
+- Ansible >= 2.14
+- Debian or Ubuntu
+- A static IP address on the target host
+
+## Role Variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `pihole_interface` | `{{ ansible_default_ipv4.interface }}` | Network interface |
+| `pihole_ipv4_address` | `{{ ansible_default_ipv4.address }}/{{ ansible_default_ipv4.prefix }}` | IP/CIDR |
+| `pihole_dns_1` | `8.8.8.8` | Primary upstream DNS |
+| `pihole_dns_2` | `8.8.4.4` | Secondary upstream DNS |
+| `pihole_query_logging` | `"true"` | Enable query logging |
+| `pihole_install_web_server` | `"true"` | Install lighttpd web server |
+| `pihole_install_web_interface` | `"true"` | Install web admin interface |
+| `pihole_lighttpd_enabled` | `"true"` | Enable lighttpd |
+| `pihole_cache_size` | `10000` | DNS cache size |
+
+## Example Playbook
+
+```yaml
+- hosts: dns_servers
+  roles:
+    - role: ansible-role-pihole
+      vars:
+        pihole_dns_1: 1.1.1.1
+        pihole_dns_2: 1.0.0.1
+```
+
+## License
+
+MIT