aboutsummaryrefslogtreecommitdiff
path: root/unsorted/docker_compose_stacks/pihole-via-tailscale/README.md
diff options
context:
space:
mode:
authorAlex Pooley (@zuedev) <zuedev@gmail.com>2026-05-25 09:08:11 +0100
committerAlex Pooley (@zuedev) <zuedev@gmail.com>2026-05-25 09:08:11 +0100
commit9404d187f2d645435fbbbe35982e488851f83ee8 (patch)
tree5d3f51deb8e177d353deedeea4206af002aed1a6 /unsorted/docker_compose_stacks/pihole-via-tailscale/README.md
parent481378543fb0601062726b54d141b0687d579eaa (diff)
downloadmonorepo-9404d187f2d645435fbbbe35982e488851f83ee8.tar
monorepo-9404d187f2d645435fbbbe35982e488851f83ee8.tar.gz
monorepo-9404d187f2d645435fbbbe35982e488851f83ee8.tar.bz2
monorepo-9404d187f2d645435fbbbe35982e488851f83ee8.tar.xz
monorepo-9404d187f2d645435fbbbe35982e488851f83ee8.zip
add old content
Diffstat (limited to 'unsorted/docker_compose_stacks/pihole-via-tailscale/README.md')
-rw-r--r--unsorted/docker_compose_stacks/pihole-via-tailscale/README.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/unsorted/docker_compose_stacks/pihole-via-tailscale/README.md b/unsorted/docker_compose_stacks/pihole-via-tailscale/README.md
new file mode 100644
index 0000000..47b6869
--- /dev/null
+++ b/unsorted/docker_compose_stacks/pihole-via-tailscale/README.md
@@ -0,0 +1,34 @@
+# Pi-hole via Tailscale
+
+A Docker Compose stack that runs [Pi-hole](https://pi-hole.net/) behind [Tailscale](https://tailscale.com/), making your Pi-hole instance accessible only via your Tailnet.
+
+## Services
+
+- **Pi-hole** - Network-wide ad blocking DNS server
+- **Tailscale** - Secure mesh VPN for private network access
+
+## Setup
+
+1. Change the `WEBPASSWORD` environment variable in `docker-compose.yaml` to a secure password
+2. Start the stack:
+ ```bash
+ docker compose up -d
+ ```
+3. Get the Tailscale login URL:
+ ```bash
+ docker compose logs -f tailscale
+ ```
+4. Open the login URL in your browser to authenticate with Tailscale
+5. Access Pi-hole's admin interface at `http://pihole:80/admin` from any device on your Tailnet
+
+## Configuration
+
+- **Timezone**: Set via `TZ` environment variable (default: `Europe/London`)
+- **Web Password**: Set via `WEBPASSWORD` environment variable
+- **DNS Listening Mode**: Set to `ALL` to accept queries from all origins
+
+## Volumes
+
+- `./etc-pihole` - Pi-hole configuration
+- `./etc-dnsmasq.d` - dnsmasq configuration
+- `./tailscale-data` - Tailscale state