Important
I've marked this project as UNMAINTAINED because it hasn't seen an update in a while. You can still fork/download/use this project at your own risk, but I won't be able to provide support or updates.
This project is forked from the Pi-hole Admin Dashboard, which was made using AdminLTE.
This project will create a Web interface for the ad-blocking Pi-hole. From this interface, you will be able to see stats on how well your Pi-hole is performing and update the lists used to block ads. The goal of this project is to make a lighter, more feature-packed version of the interface created by the Pi-hole team.
Use the following commands to manually install this web interface:
- Change to the web server directory:
cd /var/www/html
- (If updating) Remove the previous version of the web interface:
sudo rm -r admin/
- Clone the repository into a new
admin
folder:git clone --depth 1 https://github.com/jerboa88/Custom-PiHole-Interface.git admin
- (Optional) Remove unused files:
sudo rm -r admin/.git/ admin/.github/
- Profit!
Desktop site | |
---|---|
Mobile site | |
---|---|
A read-only API can be accessed at /admin/api.php
that returns a JSON response similar to the following:
{
"domains_being_blocked": "136,708",
"dns_queries_today": "18,108",
"ads_blocked_today": "14,648",
"ads_percentage_today": "80.9"
}
The following query parameters can be used to access other information from the API:
?summaryRaw
?overTimeData
?topItems
?recentItems
?getQueryTypes
?getForwardDestinations
,?getQuerySources
?getAllQueries
This project is unmaintained and as such, I am no longer accepting pull requests. If you have something to add, feel free to fork this project.
This project is licensed under the MIT License. See LICENSE for details.