Skip to content

Latest commit

 

History

History
48 lines (33 loc) · 2.84 KB

README.md

File metadata and controls

48 lines (33 loc) · 2.84 KB
Raw

How to Install Pi-Hole in Container

This guide assumes you have already created and started an nspawn container as instructed in the main README, and have configured an isolated macvlan network for your container.

To install pihole, we simply run the automated install as instructed in the pihole documentation and follow the prompts.

  1. Spawn a shell to your container.

    machinectl shell debian-custom

  2. Run the automated install command from the pihole documentation and follow the prompts. Refer to the pihole documentation for more details.

    apt -y install curl
curl -sSL https://install.pi-hole.net | PIHOLE_SKIP_OS_CHECK=true bash
    • You must use PIHOLE_SKIP_OS_CHECK=true so pihole can be installed on Debian unstable.
    • After installation, the debian-custom container has a size of 611 MB after running apt clean to delete the package cache.

  3. When the install says a static IP is needed, press Continue.

  4. Select an upstream DNS provider on the next page, or add your custom DNS provider. Note all these options can be changed later in the admin panel, so you don't need to be perfect here.

  5. On the next page, choose "Yes" to include the default list or "No" to not include any block lists at install (you will have to install your own later in that case).

  6. On the next page, choose "Yes" to install the Admin web interface, then "Yes" on the next page to install the default web server that pihole uses (lighthttpd). It's also possible to use nginx instead of lighthttpd, but this isn't covered in this tutorial.

  7. On the next two pages, click Yes to enable Query Logging, and enable "Show everything". You can disable query logging or hide information from the log if you prefer.

  8. Once the install is finished, it will tell you what your pihole IP and admin password is.

  9. You can either use the current admin password the installation gave you, or run pihole -a -p to update the password.

  10. You should now be able to access the pihole admin page at https://10.0.5.3/admin if you used the default container IP.

  11. As a final step, you need to set "Permit all origins" in the Pi-Hole Admin to allow requests from more than one hop away (i.e. your LAN clients). Go to Pi-Hole Admin -> Settings -> DNS -> Permit all origins -> Save.

  12. Now you can set your LAN clients to use the pihole IP 10.0.5.3 as the DNS, or use dig to test DNS resolution from a client (e.g.: dig @10.0.5.3 google.com A).

How to Update or Reconfigure Pi-Hole.

To update pihole, simply run the following from within the container.

PIHOLE_SKIP_OS_CHECK=true pihole -up

In case there is a configuration error and pihole is having trouble, you can reconfigure it from scratch by running:

PIHOLE_SKIP_OS_CHECK=true pihole -r