diff options
| author | Alex Pooley (@zuedev) <zuedev@gmail.com> | 2026-05-25 09:08:11 +0100 |
|---|---|---|
| committer | Alex Pooley (@zuedev) <zuedev@gmail.com> | 2026-05-25 09:08:11 +0100 |
| commit | 9404d187f2d645435fbbbe35982e488851f83ee8 (patch) | |
| tree | 5d3f51deb8e177d353deedeea4206af002aed1a6 /unsorted/docker_compose_stacks/pihole-via-tailscale/README.md | |
| parent | 481378543fb0601062726b54d141b0687d579eaa (diff) | |
| download | monorepo-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.md | 34 |
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 |
