Changing Pi-hole’s Logo and Icon to Custom Images

Kristopher Wood
3 min readDec 12, 2019

--

For my Pi-Hole running on Ubuntu I chose a cinnamon roll

Pi-hole isn’t exclusive to just being ran on Raspberry Pi’s Linux flavors or hardware, and you may have it installed on a virtual machine running Ubuntu server, in a Docker container, or even on an old laptop running CentOS. In those cases some of you may find Pi-hole’s logo and icons a bit out of character and might want to change them. Luckily changing these is easy because Pi-hole saves both the favicon and images in the server running Pi-Hole.

This guide was written for Pi-hole running on Ubuntu 19.10 and assumes that we already have pi-hole installed: (If you need to install Pi-Hole, a guide can be found here)

Screenshots of the files we will change

1.) First we will need to decide what we are replacing the original Pi-hole raspberry logo with. My Pi-hole is running in an Ubuntu server and I call it bunhole, I thought a cinnamon bun would be comically fitting.

2.) After we have decided what we want in the logo and icon, our next step is to create or find image files to replace the default ones with. We will need to replace two image files in Pi-hole’s web server directory; the icon ‘favicon.png’ which is 393x393 px and the ‘logo.svg’ file which is a scalable vector graphics file. For the Vector image .SVG files can be found online or created with vector image editors, I used open source Inkscape. The .PNG file can be pretty much any .PNG file, I kept mine at 393x393 px.

3.) Once the logo and icon files have been sourced, it’s time to upload them to the server that is running Pi-hole. I am running Windows 10, so I use WinSCP in order to transfer files over SFTP.

Uploading image files via WinSCP

4.) Now that the files have been uploaded the the server, connect to the server through SSH.

5.) Move the image files we uploaded to /var/www/html/admin/img/ — I had to use sudo as the Pi-hole files were owned by root.

Moving the two image files, overwriting the defaults

That’s It! Now just connect to the admin web interface of your Pi-hole and your custom logo and icon should display. If not, you may need to refresh your web browser’s cache.

Example of Pi-hole with custom logo and icon

--

--

Kristopher Wood

Knowledge is best shared openly — Security is only a temporary illusion.