Skip to content

Commit

Permalink
community-containers - add pi-hole
Browse files Browse the repository at this point in the history
Signed-off-by: Simon L <szaimen@e.mail.de>
  • Loading branch information
szaimen committed Sep 29, 2023
1 parent 3697045 commit 4fb9bff
Show file tree
Hide file tree
Showing 2 changed files with 72 additions and 0 deletions.
54 changes: 54 additions & 0 deletions community-containers/pi-hole/pi-hole.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
{
"aio_services_v1": [
{
"container_name": "nextcloud-aio-pihole",
"display_name": "Pi-hole",
"image": "pihole/pihole",
"image_tag": "latest",
"internal_port": "8573",
"restart": "unless-stopped",
"ports": [
{
"ip_binding": "",
"port_number": "53",
"protocol": "tcp"
},
{
"ip_binding": "",
"port_number": "53",
"protocol": "udp"
},
{
"ip_binding": "",
"port_number": "8573",
"protocol": "tcp"
}
],
"environment": [
"TZ=%TIMEZONE%",
"WEBPASSWORD=%PIHOLE_WEBPASSWORD%",
"DNSMASQ_LISTENING=all",
"WEB_PORT=8573"
],
"volumes": [
{
"source": "nextcloud_aio_pihole",
"destination": "/etc/pihole",
"writeable": true
},
{
"source": "nextcloud_aio_pihole_dnsmasq",
"destination": "/etc/dnsmasq.d",
"writeable": true
}
],
"backup_volumes": [
"nextcloud_aio_pihole",
"nextcloud_aio_pihole_dnsmasq"
],
"secrets": [
"PIHOLE_WEBPASSWORD"
]
}
]
}
18 changes: 18 additions & 0 deletions community-containers/pi-hole/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
## Pi-hole
This container bundles pi-hole and auto-configures it for you.

### Notes
- You should not run this container on a public VPS! It is only intended to run in home networks!
- Make sure that no dns server is already running by checking with `sudo netstat -tulpn | grep 53`. Otherwise the container will not be able to start!
- The DHCP functionality of Pi-hole has been disabled!
- The data of pi-hole will be automatically included in AIOs backup solution!
- After adding and starting the container, you can visit `http://ip.address.of.this.server:8573` in order to log in with the admin key that you can retrieve when running `sudo docker inspect nextcloud-aio-pihole | grep WEBPASSWORD`. There you can configure the pi-hole setup. Also you can add local dns records.
- You can configure your home network now to use pi-hole as its dns server by configuring your router.
- Additionally, you can configure the docker daemon to use that by editing `/etc/docker/daemon.json` and adding ` { "dns" : [ "ip.addres.of.this.server" , "8.8.8.8" ] } `.

Check failure on line 11 in community-containers/pi-hole/readme.md

View workflow job for this annotation

GitHub Actions / Check spelling

addres ==> address
- See https://github.com/nextcloud/all-in-one/tree/main/community-containers how to add it to the AIO stack

### Repository
https://github.com/dani-garcia/vaultwarden

### Maintainer
https://github.com/szaimen

0 comments on commit 4fb9bff

Please sign in to comment.