https://github.com/iloveitaly/pihole-scheduled-blocking
Customized pihole image to schedule blocking & allowing domains. Includes extensive domain blacklist by default.
https://github.com/iloveitaly/pihole-scheduled-blocking
digital-minimalism docker pihole
Last synced: 27 days ago
JSON representation
Customized pihole image to schedule blocking & allowing domains. Includes extensive domain blacklist by default.
- Host: GitHub
- URL: https://github.com/iloveitaly/pihole-scheduled-blocking
- Owner: iloveitaly
- License: mit
- Created: 2022-05-31T15:49:06.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2025-04-08T12:01:27.000Z (about 1 month ago)
- Last Synced: 2025-04-08T13:21:52.583Z (about 1 month ago)
- Topics: digital-minimalism, docker, pihole
- Language: Shell
- Homepage: https://hub.docker.com/r/iloveitaly/pihole-scheduled-blocking
- Size: 51.8 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PiHole With Scheduled Blocking
As part of my [digital minimalism kick](https://mikebian.co/tag/digital-minimalism/) I wanted to automatically block websites in my home. This docker image extends the default pihole image to provide a mechanism to automatically block and allow websites based on a schedule.
It also blocks DNS over HTTPS, blocks a wider array of sites by default (porn, gambling, malware, etc), and allows alexa to work even if you schedule amazon.com to be blocked.
DNS is configured to use [Quad9](https://www.quad9.net/service/service-addresses-and-features).
## Usage
Best way to use this is via `docker-compose`. Here's an example [docker-compose.yml](./docker-compose.yml) file.
[Here's the image on docker hub.](https://hub.docker.com/r/iloveitaly/pihole-scheduled-blocking)
Note that if you update the image you may need to remove the volume completely if you are using `docker-compose.yml`. This is because we mount `/etc` to a volume and if the image update assumes a fully-updated `/etc` you will run into weird issues.
### Manual Override
In some scenarios, the block/allow scripts may glitch out and leave your blocking in an undesired state. Here's how to manually run a command to fix this:
```shell
docker compose exec pihole ./allow.sh
```
## Customization
* You can override the `blocklist` file
* You can override the `whitelist` file
* Check out the ENV definitions in the Dockerfile to customize the cron schedule
## Development
Some helpful commands are included in the Dockerfile. Most of the magic happens in `install.sh`