Using Pi-hole with Unbound - Revision history

Prabuanand: added note on delay in pizero2w

2025-11-07T19:19:56Z

added note on delay in pizero2w

← Older revision		Revision as of 19:19, 7 November 2025
Line 51:		Line 51:

	Ensure that your clients point their DNS to Pi-hole ip address:192.168.1.3 to enjoy Ad-Free browsing!		Ensure that your clients point their DNS to Pi-hole ip address:192.168.1.3 to enjoy Ad-Free browsing!

			== Diskless Pihole ==

			The same setup can be installed on a [[Diskless Mode]] installation. Be aware of delay in booting up of, if installed on a pizero2W as per {{Issue\|17681}}.

	== See also ==		== See also ==

Prabuanand: added note on http://pi.hole and wikilink

2025-11-06T15:44:51Z

added note on http://pi.hole and wikilink

← Older revision		Revision as of 15:44, 6 November 2025
Line 34:		Line 34:
	{{ic\|pihole}} service can be managed using standard '''start\|stop\|restart''' [[OpenRC]] commands. To start the service immediately:{{Cmd\|$ doas rc-service pihole start}}		{{ic\|pihole}} service can be managed using standard '''start\|stop\|restart''' [[OpenRC]] commands. To start the service immediately:{{Cmd\|$ doas rc-service pihole start}}

	== Using web interface ==		== Using web interface to configure Pi-hole ==

	The Pi-hole web interface can be used only if the {{ic\|pihole}} service is started as per instructions in the [[#Service management\|service management]] section. Once the {{ic\|pihole}} service is started, connect to Pi-hole web interface for further configuration: '''https://192.168.1.3/admin/'''		The Pi-hole web interface can be used only if the {{ic\|pihole}} service is started as per instructions in the [[#Service management\|service management]] section. Once the {{ic\|pihole}} service is started, connect to Pi-hole web interface for further configuration: '''https://192.168.1.3/admin/'''
Line 42:		Line 42:
	Add unbound to the Custom DNS servers section on the admin page: https://192.168.1.3/admin/settings/dns as follows:'''127.0.0.1#5335'''		Add unbound to the Custom DNS servers section on the admin page: https://192.168.1.3/admin/settings/dns as follows:'''127.0.0.1#5335'''

	Remember to '''Save&Apply''' to make the changes to Pi-hole permanent.		Remember to '''Save&Apply''' to make the changes to Pi-hole permanent. From now onwards, you can start using Pi-hole ip address:192.168.1.3 as DNS server for your clients. From clients using 192.168.1.3 as DNS, Pi-hole admin page can be reached at http://pi.hole/admin/

	=== Add blocklist file ===		=== Add blocklist file ===

	On the Subscribed lists group management page at ~~https~~://~~192~~.~~168.1.3~~/admin/groups/lists, add ~~stevenblack~~ list by adding an entry '''<nowiki>http://sbc.io/hosts/hosts</nowiki>''' and Click '''Add blocklist''' button.		On the Subscribed lists group management page at http://pi.hole/admin/groups/lists, add [[Using Unbound as an Ad-blocker#Ad-blocker blacklists\|steven black list]] by adding an entry '''<nowiki>http://sbc.io/hosts/hosts</nowiki>''' and Click '''Add blocklist''' button.

	To load the blocklist, Update Gravity (list of blocked domains) by clicking '''Update''' on the page ~~https~~://~~192~~.~~168.1.3~~/admin/gravity or running the command: {{Cmd\|$ pihole -g}}		To load the blocklist, Update Gravity (list of blocked domains) by clicking '''Update''' on the page http://pi.hole/admin/gravity or running the command: {{Cmd\|$ pihole -g}}

	Ensure that your clients point their DNS to Pi-hole ip address:192.168.1.3		Ensure that your clients point their DNS to Pi-hole ip address:192.168.1.3 to enjoy Ad-Free browsing!

	~~Enjoy Ad-Free browsing!~~		== See also ==

	~~== See also ==~~
	* [https://docs.pi-hole.net/ Official Pi-hole documentation]		* [https://docs.pi-hole.net/ Official Pi-hole documentation]
	* [https://docs.pi-hole.net/guides/dns/unbound/ Pi-hole as All-Around DNS Solution]		* [https://docs.pi-hole.net/guides/dns/unbound/ Pi-hole as All-Around DNS Solution]

Prabuanand: moved headings with some clarifications

2025-11-05T14:21:55Z

moved headings with some clarifications

← Older revision		Revision as of 14:21, 5 November 2025
Line 3:		Line 3:
	== Prerequisites ==		== Prerequisites ==

	* ~~You should have a~~ {{Pkg\|dnsmasq}} (or another DHCP server/router) on ~~your~~ network as DHCP ~~functions~~ of Pi-hole is not used here.		* A {{Pkg\|dnsmasq}} (or another DHCP server/router) on the network, as DHCP function of Pi-hole is not used here.

	== Installation ==		== Installation ==
Line 19:		Line 19:
	=== Unbound configuration ===		=== Unbound configuration ===

	Create a file {{Path\|/etc/unbound/unbound.conf.d/pi-hole.conf}} based on the content given in [https://docs.pi-hole.net/guides/dns/unbound unbound page of Pi-hole website].		Create a file {{Path\|/etc/unbound/unbound.conf.d/pi-hole.conf}} based on the content given in [https://docs.pi-hole.net/guides/dns/unbound/#configure-unbound unbound page of Pi-hole website].

	[[Setting_up_unbound_DNS_server#Download root hints\|Download root hints]] for the Unbound server.		[[Setting_up_unbound_DNS_server#Download root hints\|Download root hints]] for the Unbound server.
Line 27:		Line 27:

	Once the above changes are made, [[Setting_up_unbound_DNS_server#Service_management\|check the unbound config and restart the unbound service]].		Once the above changes are made, [[Setting_up_unbound_DNS_server#Service_management\|check the unbound config and restart the unbound service]].

			== Service management ==

			Add the {{ic\|pihole}} service to auto-start using [[OpenRC]]: {{Cmd\|$ doas rc-update add pihole default}}

			{{ic\|pihole}} service can be managed using standard '''start\|stop\|restart''' [[OpenRC]] commands. To start the service immediately:{{Cmd\|$ doas rc-service pihole start}}

	== Using web interface ==		== Using web interface ==

	~~Start~~ the {{ic\|pihole}} service as per ~~command given~~ in [[#Service management\|~~Service~~ management]] section. Once the {{ic\|pihole}} service is started, connect to ~~pihole~~ web interface for further ~~steps~~: '''https://192.168.1.3/admin/'''		The Pi-hole web interface can be used only if the {{ic\|pihole}} service is started as per instructions in the [[#Service management\|service management]] section. Once the {{ic\|pihole}} service is started, connect to Pi-hole web interface for further configuration: '''https://192.168.1.3/admin/'''

	=== Enable recursive DNS ===		=== Enable recursive DNS ===
Line 47:		Line 53:

	Enjoy Ad-Free browsing!		Enjoy Ad-Free browsing!

	~~== Service management ==~~

	~~Add the {{ic\|pihole}} service to auto-start using [[OpenRC]]: {{Cmd\|$ doas rc-update add pihole default}}~~

	~~{{ic\|pihole}} service can be managed using standard '''start\|stop\|restart''' [[OpenRC]] commands. To start the service immediately:{{Cmd\|$ doas rc-service pihole start}}~~

	== See also ==		== See also ==
			* [https://docs.pi-hole.net/ Official Pi-hole documentation]
			* [https://docs.pi-hole.net/guides/dns/unbound/ Pi-hole as All-Around DNS Solution]
	* [[Setting_up_unbound_DNS_server\|unbound]]		* [[Setting_up_unbound_DNS_server\|unbound]]
	* [[Using Unbound as an Ad-blocker]]		* [[Using Unbound as an Ad-blocker]]
	* [https://docs.pi-hole.net/ Official Pi-hole documentation]
	* [https://docs.pi-hole.net/guides/dns/unbound/ Pi-hole as All-Around DNS Solution]

	[[Category:Networking]]		[[Category:Networking]]

Prabuanand: added unbound

2025-11-05T11:05:41Z

added unbound

← Older revision		Revision as of 11:05, 5 November 2025
Line 9:		Line 9:
	Currently the {{pkg\|pihole}} is available in the [[Repositories#Testing\|testing]] repository. It can be safely installed by following the [[Repositories#Using_testing_repository\|guidelines]] for enabling the testing repo and for installing such packages with the use of the ''@testing'' tag.		Currently the {{pkg\|pihole}} is available in the [[Repositories#Testing\|testing]] repository. It can be safely installed by following the [[Repositories#Using_testing_repository\|guidelines]] for enabling the testing repo and for installing such packages with the use of the ''@testing'' tag.

	The command below installs ~~the Alpine Linux pihole package~~:{{cmd\|$ doas apk add pihole@testing}}		The command below installs necessary packages:{{cmd\|$ doas apk add pihole@testing unbound}}

	== Configuration ==		== Configuration ==

Prabuanand: fixed Prerequisites and add heading

2025-11-05T10:11:11Z

fixed Prerequisites and add heading

← Older revision		Revision as of 10:11, 5 November 2025
Line 3:		Line 3:
	== Prerequisites ==		== Prerequisites ==

	* You should have a {{Pkg\|dnsmasq}} (or another DHCP server) ~~and [[Setting_up_unbound_DNS_server\|unbound]] both working~~ on your network.		* You should have a {{Pkg\|dnsmasq}} (or another DHCP server/router) on your network as DHCP functions of Pi-hole is not used here.

	== Installation ==		== Installation ==
Line 28:		Line 28:
	Once the above changes are made, [[Setting_up_unbound_DNS_server#Service_management\|check the unbound config and restart the unbound service]].		Once the above changes are made, [[Setting_up_unbound_DNS_server#Service_management\|check the unbound config and restart the unbound service]].

	Start the {{ic\|pihole}} service as per command given in [[#Service management\|Service management]] section. Once the {{ic\|pihole}} service is started, connect to pihole ~~admin~~ interface: https://192.168.1.3/admin/		== Using web interface ==

			Start the {{ic\|pihole}} service as per command given in [[#Service management\|Service management]] section. Once the {{ic\|pihole}} service is started, connect to pihole web interface for further steps: '''https://192.168.1.3/admin/'''

	=== Enable recursive DNS ===		=== Enable recursive DNS ===

Prabuanand: wiki format change

2025-11-04T10:19:55Z

wiki format change

← Older revision		Revision as of 10:19, 4 November 2025
Line 38:		Line 38:
	=== Add blocklist file ===		=== Add blocklist file ===

	On the Subscribed lists group management page at https://192.168.1.3/admin/groups/lists, add stevenblack list by adding an entry '''http://sbc.io/hosts/hosts''' and Click '''Add blocklist''' button.		On the Subscribed lists group management page at https://192.168.1.3/admin/groups/lists, add stevenblack list by adding an entry '''<nowiki>http://sbc.io/hosts/hosts</nowiki>''' and Click '''Add blocklist''' button.

	To load the blocklist, Update Gravity (list of blocked domains) by clicking '''Update''' on the page https://192.168.1.3/admin/gravity or running the command: {{Cmd\|$ pihole -g}}		To load the blocklist, Update Gravity (list of blocked domains) by clicking '''Update''' on the page https://192.168.1.3/admin/gravity or running the command: {{Cmd\|$ pihole -g}}

Prabuanand: https does not work

2025-11-03T17:53:03Z

https does not work

← Older revision		Revision as of 17:53, 3 November 2025
Line 38:		Line 38:
	=== Add blocklist file ===		=== Add blocklist file ===

	On the Subscribed lists group management page at https://192.168.1.3/admin/groups/lists, add stevenblack list by adding an entry '''~~https~~://sbc.io/hosts/hosts''' and Click '''Add blocklist''' button.		On the Subscribed lists group management page at https://192.168.1.3/admin/groups/lists, add stevenblack list by adding an entry '''http://sbc.io/hosts/hosts''' and Click '''Add blocklist''' button.

	To load the blocklist, Update Gravity (list of blocked domains) by clicking '''Update''' on the page https://192.168.1.3/admin/gravity or running the command: {{Cmd\|$ pihole -g}}		To load the blocklist, Update Gravity (list of blocked domains) by clicking '''Update''' on the page https://192.168.1.3/admin/gravity or running the command: {{Cmd\|$ pihole -g}}

Prabuanand: for consistency

2025-11-03T10:49:00Z

for consistency

← Older revision		Revision as of 10:49, 3 November 2025
Line 9:		Line 9:
	Currently the {{pkg\|pihole}} is available in the [[Repositories#Testing\|testing]] repository. It can be safely installed by following the [[Repositories#Using_testing_repository\|guidelines]] for enabling the testing repo and for installing such packages with the use of the ''@testing'' tag.		Currently the {{pkg\|pihole}} is available in the [[Repositories#Testing\|testing]] repository. It can be safely installed by following the [[Repositories#Using_testing_repository\|guidelines]] for enabling the testing repo and for installing such packages with the use of the ''@testing'' tag.

	The command below installs the Alpine Linux pihole package:{{cmd\|# apk add pihole@testing}}		The command below installs the Alpine Linux pihole package:{{cmd\|$ doas apk add pihole@testing}}

	== Configuration ==		== Configuration ==

Prabuanand: fixed typo

2025-11-03T10:48:20Z

fixed typo

← Older revision		Revision as of 10:48, 3 November 2025
Line 23:		Line 23:
	[[Setting_up_unbound_DNS_server#Download root hints\|Download root hints]] for the Unbound server.		[[Setting_up_unbound_DNS_server#Download root hints\|Download root hints]] for the Unbound server.

	Ensure that {{Path\|/etc/unbound/unbound.conf}} file has only the following line uncommented:{{Cat\|/etc/unbound/unbound.conf\|# All lines are to be commented out like this, except the below ...		Ensure that the {{Path\|/etc/unbound/unbound.conf}} file has only the following line uncommented:{{Cat\|/etc/unbound/unbound.conf\|# All lines are to be commented out like this, except the below ...
	include-toplevel: "/etc/unbound/unbound.conf.d/*.conf"}}		include-toplevel: "/etc/unbound/unbound.conf.d/*.conf"}}

Prabuanand: fixed typo

2025-11-03T10:45:51Z

fixed typo

← Older revision		Revision as of 10:45, 3 November 2025
Line 13:		Line 13:
	== Configuration ==		== Configuration ==

	Add your local user to the 'pihole' group as follows: {{cmd\|$ doas addgroup ~~pihole~~ $USER}}		Add your local user to the 'pihole' group as follows: {{cmd\|$ doas addgroup $USER pihole}}

	{{Note\|This section uses 192.168.1.3 as IP address of Pi-hole server, while the Internet gateway router/DHCP server is at 192.168.1.1}}		{{Note\|This section uses 192.168.1.3 as IP address of Pi-hole server, while the Internet gateway router/DHCP server is at 192.168.1.1}}
Line 23:		Line 23:
	[[Setting_up_unbound_DNS_server#Download root hints\|Download root hints]] for the Unbound server.		[[Setting_up_unbound_DNS_server#Download root hints\|Download root hints]] for the Unbound server.

	Ensure that ~~the the~~ {{Path\|/etc/unbound/unbound.conf}} ~~files~~ has only the following line uncommented ~~as follows~~:{{Cat\|/etc/unbound/unbound.conf\|# All lines are to be commented out like this, except the below ...		Ensure that {{Path\|/etc/unbound/unbound.conf}} file has only the following line uncommented:{{Cat\|/etc/unbound/unbound.conf\|# All lines are to be commented out like this, except the below ...
	include-toplevel: "/etc/unbound/unbound.conf.d/*.conf"}}		include-toplevel: "/etc/unbound/unbound.conf.d/*.conf"}}

Line 32:		Line 32:
	=== Enable recursive DNS ===		=== Enable recursive DNS ===

	Add unbound to the Custom DNS servers section on the admin page: https://192.168.1.3/admin/settings/dns as follows:''' 127.0.0.1#5335'''		Add unbound to the Custom DNS servers section on the admin page: https://192.168.1.3/admin/settings/dns as follows:'''127.0.0.1#5335'''

	Remember to '''Save&Apply''' to make the changes to Pi-hole permanent.		Remember to '''Save&Apply''' to make the changes to Pi-hole permanent.
Line 38:		Line 38:
	=== Add blocklist file ===		=== Add blocklist file ===

	On the Subscribed lists group management page at https://192.168.1.3/admin/groups/lists, add stevenblack list by adding an entry '''~~http~~://sbc.io/hosts/hosts''' and Click '''Add blocklist''' button.		On the Subscribed lists group management page at https://192.168.1.3/admin/groups/lists, add stevenblack list by adding an entry '''https://sbc.io/hosts/hosts''' and Click '''Add blocklist''' button.

	To load the blocklist, Update Gravity (list of blocked domains) by clicking '''Update''' on the page https://192.168.1.3/admin/gravity or running the command: {{Cmd\|$ pihole -g}}		To load the blocklist, Update Gravity (list of blocked domains) by clicking '''Update''' on the page https://192.168.1.3/admin/gravity or running the command: {{Cmd\|$ pihole -g}}