lawliet89 / pi-doh-ansible

Configure DNS over HTTPS for your Pi.hole on Raspberry Pi

PiHole DNS Over HTTPS

This repository contains a simple Ansible Playbook to setup DNS over HTTPS for your Pi.Hole on your ARM Raspberry Pi.

This is based on the instructions posted here.

You can find the list of available DNS over HTTPS servers here.

Usage

1. Install Ansible for your controlling machine.

2. Execute the playbook. The example below should be sufficient for most needs. If you want to override any variables, see the CLI Documentation.

   • The -i flag specifies the server address of your Raspberry Pi. You can replace the pi.hole with your Pi's address. Remember to add a trailing , at the end to indicate that this is not a path to a file. See the user guide to inventory for more information.
   • Change the --user flag for the user to SSH with in case you have a different username.
   • Add the --ask-become-pass flag if you have set a sudo password.

   ansible-playbook -i "pi.hole," \
       --user pi \
       site.yml

3. Configure Pi.hole to use the local 127.0.0.1#5533 DNS server.