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
adminfolder:git clone --depth 1 https://github.com/twocaretcat/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.







