mirror of
https://github.com/pi-hole/pi-hole.git
synced 2024-11-15 02:42:58 +00:00
describe settings page in the order they appear on the dashboard--also add screenshots
Signed-off-by: Jacob Salmela <github@decoy.email>
This commit is contained in:
parent
9348a8ab15
commit
24df5f5208
1 changed files with 86 additions and 14 deletions
100
README.md
100
README.md
|
@ -78,31 +78,108 @@ Alternatively, you can manually set each device to use Pi-hole as their DNS serv
|
||||||
|
|
||||||
## The Dashboard (Web Interface)
|
## The Dashboard (Web Interface)
|
||||||
|
|
||||||
The [Web interface](https://github.com/pi-hole/AdminLTE#pi-hole-admin-dashboard) will be installed automatically so you can view stats and change settings. You can find it at:
|
The [dashboard](https://github.com/pi-hole/AdminLTE#pi-hole-admin-dashboard) will (by default) be enabled during installation so you can view stats, change settings, and configure your Pi-hole.
|
||||||
|
|
||||||
`http://192.168.1.x/admin/index.php` or `http://pi.hole/admin`
|
![Pi-hole Dashboard](https://assets.pi-hole.net/static/dashboard.png)
|
||||||
|
|
||||||
![Pi-hole Advanced Stats Dashboard](https://assets.pi-hole.net/static/dashboard212.png)
|
There are several ways to [access the dashboard](https://discourse.pi-hole.net/t/how-do-i-access-pi-holes-dashboard-admin-interface/3168):
|
||||||
|
|
||||||
### Whitelist and blacklist
|
1. `http://<IP_ADDPRESS_OF_YOUR_PI_HOLE>/admin/`
|
||||||
|
2. `http:/pi.hole/admin/` (when using Pi-hole as your DNS server)
|
||||||
|
3. `http://pi.hole/` (when using Pi-hole as your DNS server)
|
||||||
|
|
||||||
|
### The Query Log
|
||||||
|
|
||||||
|
If enabled, the query log will show all of the DNS queries requested by clients using Pi-hole as their DNS server. Forwarded domains will show in green, and blocked (_Pi-holed_) domains will show in red. You can also white or black list domains from within this section.
|
||||||
|
|
||||||
Domains can be whitelisted and blacklisted using either the web interface or the command line. See [the wiki page](https://github.com/pi-hole/pi-hole/wiki/Whitelisting-and-Blacklisting) for more details
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<a href=https://github.com/pi-hole/pi-hole/wiki/Whitelisting-and-Blacklisting><img src="https://assets.pi-hole.net/static/whitelist212.png"></a>
|
<img src="https://assets.pi-hole.net/static/query_log.png">
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
#### Long-term Statistics
|
||||||
|
Using our Faster-Than-Light Engine ([FTL](https://github.com/pi-hole/FTL)), Pi-hole can store all of the domains queried in a database for retrieval or analysis later on. You can view this data as a graph, individual queries, or top clients/advertisers.
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="https://assets.pi-hole.net/static/long-term-stats.png">
|
||||||
|
</p>
|
||||||
|
|
||||||
|
### Whitelist And Blacklist
|
||||||
|
|
||||||
|
Domains can be [whitelisted](https://discourse.pi-hole.net/t/commonly-whitelisted-domains/212) and/or [blacklisted](https://discourse.pi-hole.net/t/commonly-blacklisted-domains/305) using either the dashboard or [the `pihole` command](https://discourse.pi-hole.net/t/the-pihole-command-with-examples/738).
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<a href=https://github.com/pi-hole/pi-hole/wiki/Whitelisting-and-Blacklisting><img src="https://assets.pi-hole.net/static/whitelist.png"></a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
#### Additional Blocklists
|
||||||
|
By default, Pi-hole blocks over 100,000 known ad-serving domains. You can expand the blocking power of your Pi-hole by [adding additional lists](https://discourse.pi-hole.net/t/how-do-i-add-additional-block-lists-to-pi-hole/259) such as the ones found on [The Big Blocklist Collection](https://wally3k.github.io/).
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<a href=https://discourse.pi-hole.net/t/how-do-i-add-additional-block-lists-to-pi-hole/259><img src="https://assets.pi-hole.net/static/manage-ad-lists.png"></a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
### Enable And Disable Pi-hole
|
||||||
|
Sometimes you may want to stop using Pi-hole or turn it back on. You can trigger this via the dashboard or command line.
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="https://assets.pi-hole.net/static/enable-disable.png">
|
||||||
|
</p>
|
||||||
|
|
||||||
|
### Tools
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="https://assets.pi-hole.net/static/tools.png">
|
||||||
|
</p>
|
||||||
|
|
||||||
|
|
||||||
|
#### Update Ad Lists
|
||||||
|
This runs `gravity` to download any newly-added domains from your source lists.
|
||||||
|
|
||||||
|
#### Query Ad Lists
|
||||||
|
You can find out what list a certain domain was on. This is useful for troubleshooting sites that may not work properly due to a blocked domain.
|
||||||
|
|
||||||
|
#### `tail`ing Log Files
|
||||||
|
You can watch the log files in real time to help debug any issues, or just see what's happening with your Pi-hole.
|
||||||
|
|
||||||
|
#### Pi-hole Debugger
|
||||||
|
If you are having trouble with your Pi-hole, this is the place to go. You can run the debugger and it will attempt to diagnose any issues and then link to an FAQ with instructions on rectifying the problem.
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<img src="https://assets.pi-hole.net/static/debug-gui.png">
|
||||||
|
</p>
|
||||||
|
|
||||||
|
If run [via the command line](https://discourse.pi-hole.net/t/the-pihole-command-with-examples/738#debug), you will see red/yellow/green text, which makes it easy to identify any problems.
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<a href=https://discourse.pi-hole.net/t/the-pihole-command-with-examples/738#debugs><img src="https://assets.pi-hole.net/static/debug-cli.png"></a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
|
||||||
|
After the debugger has finished, you have the option to upload it to our secure server for 48 hours. All you need to do then is provide one of our developers the unique token generated by the debugger (this is usually done via [our forums](https://discourse.pi-hole.net/c/bugs-problems-issues)).
|
||||||
|
|
||||||
|
<p align="center">
|
||||||
|
<a href=https://discourse.pi-hole.net/t/the-pihole-command-with-examples/738#debugs><img src="https://assets.pi-hole.net/static/debug-token.png"></a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
However, most of the time, you will be able to solve any issues without any intervention from us. But if you can't, we're always around to help out.
|
||||||
|
|
||||||
### Settings
|
### Settings
|
||||||
|
|
||||||
The settings page lets you control and configure your Pi-hole. You can do things like:
|
The settings page lets you control and configure your Pi-hole. You can do things like:
|
||||||
|
|
||||||
|
- view networking information
|
||||||
|
- flush logs or disable the logging of queries
|
||||||
- enable Pi-hole's built-in DHCP server
|
- enable Pi-hole's built-in DHCP server
|
||||||
- exclude domains from the graphs
|
- manage block lists
|
||||||
|
- exclude domains from the graphs and enable privacy options
|
||||||
- configure upstream DNS servers
|
- configure upstream DNS servers
|
||||||
|
- restart Pi-hole's services
|
||||||
|
- back up some of Pi-hole's important files
|
||||||
- and more!
|
- and more!
|
||||||
|
|
||||||
![Settings page](https://assets.pi-hole.net/static/settings212.png)
|
![Settings page](https://assets.pi-hole.net/static/settings-page.png)
|
||||||
|
|
||||||
#### Built-in DHCP Server
|
## Built-in DHCP Server
|
||||||
|
|
||||||
Pi-hole ships with a built-in DHCP server. This allows you to let your network devices use Pi-hole as their DNS server if your router does not let you adjust the DHCP options.
|
Pi-hole ships with a built-in DHCP server. This allows you to let your network devices use Pi-hole as their DNS server if your router does not let you adjust the DHCP options.
|
||||||
<p align="center">
|
<p align="center">
|
||||||
|
@ -147,11 +224,6 @@ The Pi-hole is an **advertising-aware DNS/Web server**. If an ad domain is queri
|
||||||
|
|
||||||
The [gravity.sh](https://github.com/pi-hole/pi-hole/blob/master/gravity.sh) script does most of the magic. The script pulls in over 100,000 known ad-serving domains from many sources and aggregates them into a single list.
|
The [gravity.sh](https://github.com/pi-hole/pi-hole/blob/master/gravity.sh) script does most of the magic. The script pulls in over 100,000 known ad-serving domains from many sources and aggregates them into a single list.
|
||||||
|
|
||||||
#### Additional Blocklists
|
|
||||||
You can also use Pi-hole to block additional domains beyond the defaults. It can even be used to block malware or phising domains. [The Big Blocklist Collection](https://wally3k.github.io/) is a good resource for finding additional domains to block.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
#### Other Operating Systems
|
#### Other Operating Systems
|
||||||
|
|
||||||
The automated install is only for a clean install of a Debian family or Fedora based system, such as the Raspberry Pi. However, this script will work for most UNIX-like systems, some with some slight **modifications** that we can help you work through. If you can install `dnsmasq` and a web server, it should work OK. If there are other platforms you'd like supported, let us know.
|
The automated install is only for a clean install of a Debian family or Fedora based system, such as the Raspberry Pi. However, this script will work for most UNIX-like systems, some with some slight **modifications** that we can help you work through. If you can install `dnsmasq` and a web server, it should work OK. If there are other platforms you'd like supported, let us know.
|
||||||
|
|
Loading…
Reference in a new issue