Step by step Custom Block Page

Expected Behaviour:

To have a easy way of how to install a custom block webpage with a message

Actual Behaviour:

The only information found is here : Allow for Custom block page by PromoFaux · Pull Request #1688 · pi-hole/pi-hole · GitHub

Other info :

I'm running PiHole over a month and i am glad to see everthing working as designed but in a family environment or a small business company i would really love to have a page to display a specific message.

I've tried using the pihole -r command and selected the keep my data in hopes that something somewhere will pop-up asking me if i want a custom page.

Current Pi-hole version is v5.1.2.
Current AdminLTE version is v5.1.1.
Current FTL version is v5.2.

I'm sorry to create this kind of topic but as a windows user, i dont really know what steps to take in order to make it work. I did build the custom index page with the specific resources such as the .css and .html and a .png but where do i actually store them ?

Thank you for your time.

That link is around 3 years old now.

While what you are asking is technically possible, it just doesn't work in real life anymore. Sites are all https now and that prevents people impersonating sites, pages, and content with their own content.

1 Like

Last week i've installed a full equipment provided by forti. They have this kind of feature in the admin panel , so if pihole is kinda a little small part of forti does for a network, i guess that can be possible to simple redirect to a 404 page

Sure, if you want to create your own Certificate Authority and install self-signed certificates for every client, but that's rather dangerous to do.

Or, in other words, for the less experienced :slight_smile: :

When you host a block page on a https page, your browser will just show

(took this from a random search on Google, this is not my own picture!)

You gain (virtually) nothing from this, right? The reason for this is, by the way, very simple: You cannot authenticate yourself as being the legit owner of www.kia.com. Hence, you cannot serve content (the block page) on their behalf.

The only way to circumvent this is to do what DanSchaper suggested above. It involves tinkering around with certificates and local authorities so your browser thinks you are the legit owner of www.kia.com. This is dangerous as others conquering your local network (somehow) may do the same for your online banking, etc.


Their feature will also not work on https (which is the vast majority of websites today). It will work on http (no s) traffic, but Pi-hole does the very same by default, already.

Just set BLOCKINGMODE=IP in /etc/pihole/pihole-FTL.conf (create the file if there is none) and run pihole restartdns afterwards.

This topic was automatically closed 21 days after the last reply. New replies are no longer allowed.