From d309d26685e3ec4fed3434adce7dad9addbe5dfb Mon Sep 17 00:00:00 2001 From: DL6ER Date: Mon, 16 Dec 2024 10:30:30 +0100 Subject: [PATCH] Add example on how to use Home Assistant to control Pi-hole enable and disable through automations Signed-off-by: DL6ER --- docs/guides/misc/homeassistant.md | 135 ++++++++++++++++++++++ docs/images/home-assistant/automation.png | Bin 0 -> 55937 bytes docs/images/home-assistant/boolean.png | Bin 0 -> 14754 bytes mkdocs.yml | 1 + 4 files changed, 136 insertions(+) create mode 100644 docs/guides/misc/homeassistant.md create mode 100644 docs/images/home-assistant/automation.png create mode 100644 docs/images/home-assistant/boolean.png diff --git a/docs/guides/misc/homeassistant.md b/docs/guides/misc/homeassistant.md new file mode 100644 index 0000000..55a5bc0 --- /dev/null +++ b/docs/guides/misc/homeassistant.md @@ -0,0 +1,135 @@ +# Automating your Pi-hole with Home Assistant + +Home Assistant is an open-source home automation platform. It is able to track and control all devices at home and offer a platform for automating control. This guide will show you some examples how to integrate Pi-hole's API with Home Assistant. Feel free to adapt the examples to your needs. + +## Prerequisites + +- A running Home Assistant instance +- Pi-hole installed and running + +## Example 1: Use a boolean switch to enable/disable Pi-hole blocking + +1. Add to your [`secrets.yaml`](https://www.home-assistant.io/docs/configuration/secrets/): + ```yaml + pi_hole_password: "your_pihole_password" + pi_hole_api_url: "http://192.168.1.2/api" + ``` +2. Add to your [`configuration.yaml`](https://www.home-assistant.io/docs/configuration/): + ```yaml + rest_command: + pihole_login: + url: '{{ api_url }}/auth' + method: POST + payload: '{ "password" : "{{ password }}" }' + content_type: 'application/json; charset=utf-8' + verify_ssl: false + pihole_logout: + url: '{{ api_url }}/auth' + method: DELETE + verify_ssl: false + headers: + sid: "{{ sid }}" + pihole_set_blocking: + url: '{{ api_url }}/dns/blocking' + method: POST + payload: '{ "blocking" : {{ blocking }}, "timer" : {{ timer }} }' + content_type: 'application/json; charset=utf-8' + verify_ssl: false + headers: + sid: "{{ sid }}" + + input_boolean: + pihole_blocking: + name: Pi-Hole Blocking + initial: on + icon: mdi:block-helper + ``` +3. Add to your [`scripts.yaml`](https://www.home-assistant.io/docs/scripts/): + ```yaml + pi_hole_disable: + sequence: + - action: rest_command.pihole_login + data: + api_url: !secret pi_hole_api_url + password: !secret pi_hole_password + response_variable: response + - condition: template + value_template: "{{ response['status'] == 200 }}" + - variables: + sid: "{{ response['content']['session']['sid'] }}" + - action: rest_command.pihole_set_blocking + data: + api_url: !secret pi_hole_api_url + sid: "{{ sid }}" + blocking: "false" + timer: "300" # can be "null" for permanent + - action: rest_command.pihole_logout + data: + api_url: !secret pi_hole_api_url + sid: "{{ sid }}" + + pi_hole_enable: + sequence: + - action: rest_command.pihole_login + data: + password: !secret pi_hole_password + api_url: !secret pi_hole_api_url + response_variable: response + - condition: template + value_template: "{{ response['status'] == 200 }}" + - variables: + sid: "{{ response['content']['session']['sid'] }}" + - action: rest_command.pihole_set_blocking + data: + api_url: !secret pi_hole_api_url + sid: "{{ sid }}" + blocking: "true" + timer: "null" + - action: rest_command.pihole_logout + data: + api_url: !secret pi_hole_api_url + sid: "{{ sid }}" + ``` +4. Add to your [`automations.yaml`](https://www.home-assistant.io/docs/automation/): + ```yaml + - id: '1734339971405' + alias: Disable Pi-hole Blocking + description: '' + triggers: + - trigger: event + event_type: pi_hole_disable + - entity_id: input_boolean.pihole_blocking + to: 'off' + trigger: state + conditions: [] + actions: + - action: script.pi_hole_disable + data: {} + mode: single + - id: '1734339971406' + alias: Enable Pi-hole Blocking + description: '' + triggers: + - trigger: event + event_type: pi_hole_enable + - entity_id: input_boolean.pihole_blocking + to: 'off' + trigger: state + conditions: [] + actions: + - action: script.pi_hole_enable + data: {} + mode: single + ``` + +You can use the created `input_boolean.pihole_blocking` to enable or disable Pi-hole blocking + +![Pi-hole Blocking](../../images/home-assistant/boolean.png) + +The `pi_hole_disable` script will disable Pi-hole blocking for 5 minutes, while the `pi_hole_enable` script will enable Pi-hole blocking permanently. We created two automations to trigger the scripts based on the state of the `input_boolean.pihole_blocking`, e.g., when the boolean is turned off, the `pi_hole_disable` script will be triggered: + +![Pi-hole Blocking Automation](../../images/home-assistant/automation.png) + +This automation may be enriched with additional triggers, e.g., automatically disable Pi-hole blocking when changing the color of a specific light to red and re-enable it when the light is turned back to green. You can also add a notification to inform you about the change. + +Note that this example does not check the status of Pi-hole before enabling or disabling blocking, i.e., in the mentioned example of a lamp changing color, the lamp will *not* change its color if Pi-hole's blocking state is changed elsewhere, e.g., from the web interface or the CLI. diff --git a/docs/images/home-assistant/automation.png b/docs/images/home-assistant/automation.png new file mode 100644 index 0000000000000000000000000000000000000000..5f25852fbd0a2604bfe51f21b99d54f01133a467 GIT binary patch literal 55937 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 literal 0 HcmV?d00001 diff --git a/docs/images/home-assistant/boolean.png b/docs/images/home-assistant/boolean.png new file mode 100644 index 0000000000000000000000000000000000000000..477383e10496318e1060447f5a8c59f8ae07f4c4 GIT binary patch literal 14754 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 TAr0RWL!r