diff --git a/README.md b/README.md index 7a4c58dd..6b14b40b 100644 --- a/README.md +++ b/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 [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:///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. + +

+ +

+ +#### 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. + +

+ +

+ +### 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). + +

+ +

+ +#### 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/). + +

+ +

+ +### 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. + +

+ +

+ +### Tools + +

+ +

+ + +#### 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. -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

- +

+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. + +

+ +

+ + +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)). + +

+ +

+ +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 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 -- exclude domains from the graphs +- manage block lists +- exclude domains from the graphs and enable privacy options - configure upstream DNS servers +- restart Pi-hole's services +- back up some of Pi-hole's important files - 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.

@@ -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. -#### 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 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.