Skip to content

Commit

Permalink
Merge pull request #1173 from pi-hole/docker
Browse files Browse the repository at this point in the history
Add note on Custom dnsmasq config files for Docker installations
  • Loading branch information
PromoFaux authored Feb 20, 2025
2 parents 0c91725 + 04bb3c9 commit 3c8a6d1
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 0 deletions.
2 changes: 2 additions & 0 deletions docs/docker/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,8 @@ Given the below `toml` formatted example from `pihole.toml`, we can translate th
dnssec = true
```

Array type configs should be delimited with `;`

!!! note
All FTL settings that are set via environment variables effectively become read-only, meaning that you will not be able to change them via the web interface or CLI. This is to ensure a "single source of truth" on the config. If you later unset or remove an environment variable, then FTL will revert to the default value for that setting

Expand Down
11 changes: 11 additions & 0 deletions docs/docker/upgrading/v5-v6.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,17 @@ You would now set:
FTLCONF_dns_revServers: 'true,192.168.0.0/24,192.168.0.1#53,lan'
```

### Custom dnsmasq config files

By default, Pi-hole v6 no longer reads configuration files from `/etc/dnsmasq.d/`. If you want Pi-hole to read files from this location you should:

1. Mount the local folder containing the config files into `/etc/dnsmasq.d` into the container
2. Set the environment variable `FTLCONF_misc_etc_dnsmasq_d: 'true'`


If you only want to add a single/few `dnsmasq` config lines you can use the variable `FTLCONF_misc_dnsmasq_lines`. Each line should be separated with `;`


### Removed Variables

The following variables can be removed without replacement, as they are no longer used:
Expand Down

0 comments on commit 3c8a6d1

Please sign in to comment.