nicole
289769a601
Automatic Documentation Deployment / Sync Docs to https://kb.bunny-lab.io (push) Successful in 8s
54 lines
1.8 KiB
Markdown
54 lines
1.8 KiB
Markdown
---
|
|
tags:
|
|
- Pi-hole
|
|
- DNS
|
|
- Docker
|
|
---
|
|
|
|
## Purpose
|
|
Pi-hole is a Linux network-level advertisement and Internet tracker blocking application which acts as a DNS sinkhole and optionally a DHCP server, intended for use on a private network.
|
|
|
|
```yaml title="docker-compose.yml"
|
|
version: "3"
|
|
|
|
# More info at https://github.com/pi-hole/docker-pi-hole/ and https://docs.pi-hole.net/
|
|
services:
|
|
pihole:
|
|
container_name: pihole
|
|
image: pihole/pihole:latest
|
|
# For DHCP it is recommended to remove these ports and instead add: network_mode: "host"
|
|
ports:
|
|
- "53:53/tcp"
|
|
- "53:53/udp"
|
|
- "67:67/udp" # Only required if you are using Pi-hole as your DHCP server
|
|
- "80:80/tcp"
|
|
environment:
|
|
TZ: 'America/Denver'
|
|
WEBPASSWORD: 'REDACTED' #USE A SECURE PASSWORD HERE
|
|
# Volumes store your data between container upgrades
|
|
volumes:
|
|
- /srv/containers/pihole/app:/etc/pihole
|
|
- /srv/containers/pihole/etc-dnsmasq.d:/etc/dnsmasq.d
|
|
# https://github.com/pi-hole/docker-pi-hole#note-on-capabilities
|
|
cap_add:
|
|
- NET_ADMIN # Required if you are using Pi-hole as your DHCP server, else not needed
|
|
restart: always
|
|
networks:
|
|
docker_network:
|
|
ipv4_address: 192.168.5.190
|
|
networks:
|
|
default:
|
|
external:
|
|
name: docker_network
|
|
docker_network:
|
|
external: true
|
|
```
|
|
|
|
```yaml title=".env"
|
|
Not Applicable
|
|
```
|
|
|
|
## Related Documentation
|
|
- [Docker Network Prerequisite](<../../Containers/Docker/Create the Docker Network.md>) — The configuration references the external `docker_network`; prepare it on the intended Docker host.
|
|
- [Related Networking and Access Documentation](<../../../reference/Networking and Access/index.md>) — Find the connected deployments, procedures, and references for this subject.
|