https://gitlab.com/cwassall/cloudflared-pi-hole
A docker-compose.yml file for running a Pi-hole container and routing DNS via a cloudflared tunnel.
https://gitlab.com/cwassall/cloudflared-pi-hole
cloudflared docker-compose pi-hole
Last synced: 5 months ago
JSON representation
A docker-compose.yml file for running a Pi-hole container and routing DNS via a cloudflared tunnel.
- Host: gitlab.com
- URL: https://gitlab.com/cwassall/cloudflared-pi-hole
- Owner: cwassall
- Created: 2022-09-22T17:55:50.321Z (over 3 years ago)
- Default Branch: main
- Last Synced: 2025-02-13T07:48:06.516Z (over 1 year ago)
- Topics: cloudflared, docker-compose, pi-hole
- Stars: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Cloudflared Pi-hole
A `docker-compose.yml` file for running a [Pi-hole](https://pi-hole.net) container and routing DNS via a [cloudflared](https://github.com/cloudflare/cloudflared) tunnel.
DNS routing is done via the [cwassall/cloudflared](https://gitlab.com/cwassall/cloudflared) Docker image for increased compatibility over the original.
### Windows DHCP
Windows hosts do not support `network_mode: host` or `macvlan` networks which are the preferred methods of supporting DHCP servers in Docker containers, however it is possible to work around this by installing in a Linux Hyper-V virtual machine with an External Virtual Switch, provided the Hyper-V host and virtual machine have a static IP address.
## Getting started
1. Ensure the host device has a static IP address on the local network
1. Clone the repo:
```
$ git clone git@gitlab.com:cwassall/cloudflared-pi-hole.git
```
1. Modify the `.env` file to override any variables in the `docker-compose.yml` file as needed
1. Run the containers:
```
$ docker compose up -d
```
1. Disable any other DHCP server on the local network