Skip to content

Commit

Permalink
add section about unattended install
Browse files Browse the repository at this point in the history
Signed-off-by: SK4ndal <email@sk4ndal.nl>
  • Loading branch information
bart authored and SK4ndal committed Sep 7, 2023
1 parent a6af0e7 commit da8d09e
Show file tree
Hide file tree
Showing 2 changed files with 39 additions and 0 deletions.
38 changes: 38 additions & 0 deletions docs/guides/misc/unattended-install.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
## Unattended Installation

Pi-hole can be installed unattended when using the installation script.

The installation script will look for the `/etc/pihole/setupVars.conf` configuration file.
If it finds this file, it will use the variables specified here during the install.
The install script will also update this file during the install process if required.

This is what the `/etc/pihole/setupVars.conf` file looks like with the quad9 dns servers specified:

``` conf
WEBPASSWORD=
PIHOLE_INTERFACE=ens18
IPV4_ADDRESS=
IPV6_ADDRESS=
QUERY_LOGGING=true
INSTALL_WEB=true
DNSMASQ_LISTENING=single
PIHOLE_DNS_1=9.9.9.9
PIHOLE_DNS_2=142.112.112.112
PIHOLE_DNS_3=2620:fe::fe
PIHOLE_DNS_4=2620:fe::9
DNS_FQDN_REQUIRED=true
DNS_BOGUS_PRIV=true
DNSSEC=true
TEMPERATUREUNIT=C
WEBUIBOXEDLAYOUT=traditional
API_EXCLUDE_DOMAINS=
API_EXCLUDE_CLIENTS=
API_QUERY_LOG_SHOW=all
API_PRIVACY_MODE=false
```

If you want to specify the webpassword yourself instead of letting the install process generate one, use a double SHA256 encrypted string like so: `echo -n P@ssw0rd | sha256sum | awk '{printf "%s",$1 }' | sha256sum`.

If you want to specify a port after an IP address use the `#` instead of `:` like so: `127.0.0.1#5353`

After creating the `/etc/pihole/setupVars.conf` file, simply run the install script with the `--unattended` flag specfified.
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -171,6 +171,7 @@ nav:
- 'Optional: Dynamic DNS': guides/vpn/openvpn/dynDNS.md
- 'Troubleshooting': guides/vpn/openvpn/troubleshooting.md
- 'Misc':
- 'Unattended installation': guides/misc/unattended-install.md
- 'Benchmarking': guides/misc/benchmark.md
- 'Tor & Pi-hole':
- 'Overview': guides/misc/tor/overview.md
Expand Down

0 comments on commit da8d09e

Please sign in to comment.