https://github.com/adamstac/pihole-docker
The easiest way to run Pi-hole
https://github.com/adamstac/pihole-docker
docker dockercompose pihole
Last synced: 4 months ago
JSON representation
The easiest way to run Pi-hole
- Host: GitHub
- URL: https://github.com/adamstac/pihole-docker
- Owner: adamstac
- License: mit
- Created: 2021-10-17T06:35:26.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-01-05T20:34:28.000Z (over 3 years ago)
- Last Synced: 2025-10-29T21:40:58.013Z (8 months ago)
- Topics: docker, dockercompose, pihole
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Pi-hole Docker
Running Pi-hole with Docker is the easiest way to run Pi-hole on your LAN. This repo makes it even easier!
## Pre-requisites
You must have Docker and Docker Compose installed. I run my Pi-hole on a Mac Mini and run Docker for Mac (Intel).
## Install and run Pi-hole
Clone the repo to your machine. I like to clone to my user root `~/pihole`.
```
gh repo clone adamstac/pihole-docker pihole
```
Then do the following to get things setup.
```
cd pihole
cp .env-example .env
vim .env
```
Set your `.env` file as you'd like. Here's my example.
```
HOSTNAME="192.169.100.10 (minipro.lan)"
WEBPASSWORD="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
TZ="America/Chicago"
```
Pull the Docker image and and run it.
```
docker-compose pull
docker-compose up -d
```
You should now be running Pi-hole via Docker.
You should something like this in your terminal.
```
[+] Running 2/2
⠿ Network pihole_default Created 0.0s
⠿ Container pihole Started 0.4s
```
You can confirm Pi-hole is running with the following command.
```
docker ps --format "table {{.ID}}\t{{.Names}}\t{{.Image}}\t{{.Status}}"
```
You should see output like this.
```
CONTAINER ID NAMES IMAGE STATUS
6fb9a1ae9175 pihole pihole/pihole:latest Up 2 minutes (healthy)
```
## Update Pi-hole
Pi-hole will let you know in the footer of the web UI when you're running outdated. To update, run the following commands.
Pull the latest.
```
docker-compose pull
```
Then, shutdown Pi-hole.
```
docker-compose down
```
Prune any left over images, then run Pi-hole again.
```
docker image prune
docker-compose up -d
```
Your Pi-hole should be running again.
## Disk shortage error
```
vim ./etc-pihole/pihole-FTL.conf
```
Add the following.
```
CHECK_DISK=0
```
Your `pihole-FTL.conf` should look something like this after you've added this line.
```
#; Pi-hole FTL config file
#; Comments should start with #; to avoid issues with PHP and bash reading this file
CHECK_DISK=0
LOCAL_IPV4=0.0.0.0
```