Refactor: Reorganize services into standalone structure
This commit is contained in:
45
optimized/standalone/Pihole/README.md
Normal file
45
optimized/standalone/Pihole/README.md
Normal file
@@ -0,0 +1,45 @@
|
||||
# Pi-hole DNS Blocker
|
||||
|
||||
This directory contains the `docker-compose.yml` for running a standalone Pi-hole DNS ad blocker.
|
||||
|
||||
## Running with Podman Compose
|
||||
|
||||
To run this service using `podman-compose`:
|
||||
|
||||
1. Navigate to this directory:
|
||||
```bash
|
||||
cd optimized/standalone/Pihole
|
||||
```
|
||||
2. Ensure you have replaced placeholder values like `WEBPASSWORD` with your actual secure password.
|
||||
3. Ensure the necessary host directories for volumes (`./etc-pihole`, `./etc-dnsmasq.d`) exist or create them.
|
||||
4. Start the service:
|
||||
```bash
|
||||
podman-compose up -d
|
||||
```
|
||||
|
||||
## Running with Podman
|
||||
|
||||
Due to `network_mode: host`, this service shares the host's network namespace and directly uses the host's IP address.
|
||||
|
||||
```bash
|
||||
podman run -d \
|
||||
--name pihole \
|
||||
--network host \
|
||||
--restart unless-stopped \
|
||||
-e TZ="America/Chicago" \
|
||||
-e WEBPASSWORD="YOURSECUREPASSWORD" \
|
||||
-e FTLCONF_webserver_enabled="true" \
|
||||
-e FTLCONF_webserver_port="7300" \
|
||||
-e WEB_BIND_ADDR="0.0.0.0" \
|
||||
-e DNS1="127.0.0.1#5335" \
|
||||
-e DNS2="0.0.0.0" \
|
||||
-v ./etc-pihole:/etc/pihole \
|
||||
-v ./etc-dnsmasq.d:/etc/dnsmasq.d \
|
||||
pihole/pihole:latest
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
* `network_mode: host` is essential for Pi-hole to function correctly as a DNS server for your local network.
|
||||
* The `WEBPASSWORD` environment variable is critical for securing your Pi-hole web interface.
|
||||
* Ensure the volume bind mounts (`./etc-pihole`, `./etc-dnsmasq.d`) are pointing to correct and persistent locations on your host.
|
||||
Reference in New Issue
Block a user