https://github.com/andrew-kandyba/dns-pihole-unbound

Pi-hole, a network-wide ad blocker, is combined with Unbound, a DNS over TLS resolver, within a docker containers
https://github.com/andrew-kandyba/dns-pihole-unbound

docker-pi-hole docker-pihole-unbound docker-unbound pi-hole pi-hole-unbound pihole unbound-dns unbound-dns-server unbound-server

Last synced: 2 days ago
JSON representation

Pi-hole, a network-wide ad blocker, is combined with Unbound, a DNS over TLS resolver, within a docker containers

• Host: GitHub
• URL: https://github.com/andrew-kandyba/dns-pihole-unbound
• Owner: andrew-kandyba
• License: mit
• Created: 2024-04-08T21:40:54.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2024-04-09T22:22:26.000Z (9 months ago)
• Last Synced: 2024-11-02T07:06:00.423Z (about 2 months ago)
• Topics: docker-pi-hole, docker-pihole-unbound, docker-unbound, pi-hole, pi-hole-unbound, pihole, unbound-dns, unbound-dns-server, unbound-server
• Language: Makefile
• Homepage:
• Size: 7.81 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# PI-HOLE + UNBOUND + DOCKER

`pihole/pihole:2024.03.2`    `mvance/unbound:1.19.3`

[Pi-hole](https://github.com/pi-hole/docker-pi-hole), a network-wide ad blocker, is combined with [Unbound](https://nlnetlabs.nl/projects/unbound/about/), a DNS over TLS resolver.

## Config

The `.env` file in the root of the project is used for configuration.

| Name | Default | Comment                                               |

|:------|:------|:------------------------------------------------------|

|  HOST_IP      |   ---     | Your LAN IP.                                          |

|  TZ      |  `America/Chicago`      | Your timezone                                         |

|  TAG      |  `local`      | Use as docker container's tag                         |

|  PROJECT      |   `my-dns`     | Use as docker image's repository alias                |

|  PI_HOLE_PORT      |  `53`     | Pi-Hole web password                                  |

|  PI_HOLE_WEB_PORT      |  `80`     | Pi-Hole web port (host)                               |

|  PI_HOLE_PASSWORD      |  `password`     | [pi.hole/admin](http://pi.hole/admin ) web password   |

|  UNBOUND_PORT      |  `5335`     | Unbound port (host)                                   |

## Test

For test is working correctly you can check [the custom A-record](./conf/records/a-records.conf):

```bash

# This should return the IP 192.168.168.192

> nslookup jqfqmenwsqeporkaaecrvqdf.my

Server:     192.168.1.12

Address:    192.168.1.12#53

Non-authoritative answer:

Name:   jqfqmenwsqeporkaaecrvqdf.my

Address: 192.168.168.192

```

## Make

```bash

> make help

build  Building pihole and unbound images.

start  Start containers.

stop   Stop and remove containers.

shell  Get root shell inside pihole container.

```