Getting Started With AdGuard Home On Raspberry Pi (vs Pi-Hole) –

In this article, I’ll be walking you through everything that you need to do in order to get started with AdGuard on your Raspberry Pi. It’s written for absolute beginners and even if you’re not as new to the world of Linux as I am (I’m still relatively new), it will help explain some concepts better than most tutorials out there.

AdGuard Home is a home-based application that protects the privacy of any device. It uses a proxy to filter web traffic, and it can also be installed on Raspberry Pi devices.

Getting Started With AdGuard Home On Raspberry Pi (vs Pi-Hole) –

Home AdGuard, a network-wide ad blocker that looks a lot like Pi-Hole on the user end, was just introduced to me. I decided to put it to the test and was blown away by the results, so I’ll tell you everything about it in this post.

AdGuard Home is an ad-blocking solution that can be installed on a Raspberry Pi with only one command line. It is available for Linux and Mac. The program setup and monitoring will thereafter be done through a web interface.

I strongly advise you to at least try it by going through the first portion of the installation process. Then I’ll show you how to change a few settings in the setup, followed by a short comparison with Pi-Hole.

If you want to get started with the Raspberry Pi fast, check out my e-book. It’s a 30-day challenge in which you learn something new every day until you’ve mastered the Raspberry Pi. The first third of the book covers the fundamentals, but the latter chapters feature tasks that you may do on your own.

Installing AdGuard Home On A Raspberry Pi

The Pi Glossary is available for download. If you’re confused by all the new terms and acronyms, get my free Raspberry Pi dictionary (PDF format)!

With only one command line, AdGuard Home may be installed on any Linux distribution running on a Raspberry Pi. To get started with AdGuard Home, follow these steps:

  • Any Linux distribution may be installed (Raspberry Pi OS Lite is a great choice).
  • Copy and paste their GitHub project’s command line.
  • Configure your computer’s DNS server to utilize AdGuard Home.

I’ll go through each one in detail now to make sure you understand everything.


AdGuard Home is installed via a command line and does not need the use of a desktop environment. Raspberry Pi OS Lite is a wonderful option if your major purpose for your Raspberry Pi setup is to utilize it as an ad-blocker. You may use whatever Raspberry Pi model you wish, but the Raspberry Pi Zero 2 is definitely the best choice.

Today’s Raspberry Pi Bootcamp Sale is 10% off. Take it a step farther. I’m here to assist you in getting started with the Raspberry Pi. Learn all of the necessary abilities in the proper sequence.

For years, I’ve had Pi-Hole operating on my Raspberry Pi Zero 1. Perhaps the new model will come with fresh software to update it:-).

In any case, using Raspberry Pi Imager on your PC is the simplest approach to flash your SD card:

  • Insert your SD card into your computer (if your computer does not have an SD card port, use this USB converter).
  • Raspberry Pi Imager is now installed and ready to use.
  • Select Raspberry Pi OS and the Lite version from the OS drop-down menu.
  • I also suggest activating SSH at this point; since there is no interface, it may be simpler to perform everything from your computer. To access the advanced settings, press CTRL+Shift+X and tick “Enable SSH.” There’s also the option of creating a unique password.
  • To begin the installation, choose your SD card (or USB stick) and click Write.


Your SD card should be ready to use within a few minutes. Plug it in and log in (pi / raspberry). If you are not yet acquainted with how to install Raspberry Pi OS, I have a full guide here that you can check out.

Installation of AdGuard in the Home

Connect to your Raspberry Pi via SSH (for more information, see this page) or continue on the Raspberry Pi screen. As with any endeavor, I suggest that you begin by upgrading your system, even if you have just recently installed it. Type the following commands: apt update sudo sudo apt-get install full-upgrade

Because these early upgrades generally include a new kernel, a reboot is definitely a good idea. reboot sudo

Are you having trouble navigating the Linux command line? First, read this article, which has the most critical instructions to memorize as well as a free printable cheat sheet with the commands at your fingertips.

Then execute curl -s -S -L | sh -s — -v to install AdGuard Home on your PC. If you need more information or want to see the source code before utilizing their script, go to their GitHub page:-).1641359685_558_Getting-Started-With-AdGuard-Home-On-Raspberry-Pi-vs-Pi-Hole

The installation is quite quick; it shouldn’t ask you any questions, and it should finish as shown in the picture, with the web interface URL and command line to control the service. You may use the following commands to stop, start, or check the status of a service:

  • Stop sudo /opt/AdGuardHome/AdGuardHome -s stop AdGuard Home
  • sudo /opt/AdGuardHome/AdGuardHome -s start AdGuard Home
  • sudo /opt/AdGuardHome/AdGuardHome -s status AdGuard Home

You can do anything through the web interface, as you’ll see, so you shouldn’t require it unless you installed it with other services and there’s a dispute. For example, Pi-Hole and AdGuard Home both utilize the same port as a DNS server, therefore if Pi-Hole is active, AdGuard Home is unlikely to start.

Raspberry Pi AdGuard Home Configuration

AdGuard Home will run a web server and provide a web interface for additional setup and service monitoring after it is installed.

Web-based user interface

To use the web interface, go to the URL provided at the conclusion of the installation. It will most likely be something along the lines of: http://RASPBERRYPI IP:3000.

In only 30 days, you’ll have mastered the Raspberry Pi. Today’s sale is 10% off. Get the eBook here. In a 30-day challenge, uncover the mysteries of the Raspberry Pi. Learn important Linux skills and put them to work on a variety of projects.

You already know the IP address if you used SSH. If not, read this article or just run the following command into your terminal: ip address

When you first visit the URL, you’ll be presented with an installation wizard:1641359686_138_Getting-Started-With-AdGuard-Home-On-Raspberry-Pi-vs-Pi-Hole

It’s really simple; the key purpose is to generate the username and password you’ll need to log in to the interface:1641359687_171_Getting-Started-With-AdGuard-Home-On-Raspberry-Pi-vs-Pi-Hole

Even if you have a tiny network, try to use a strong password since anybody with access to it can view anything you do on the Internet:-). The wizard also provides instructions for the client setups, which we’ll look at shortly. After that, you’ll have access to the main dashboard, which looks like this:1641359688_575_Getting-Started-With-AdGuard-Home-On-Raspberry-Pi-vs-Pi-Hole

Configuration of Clients

AdGuard Home has been deployed, but nothing will happen until your customers use the Raspberry Pi as their primary DNS server. This is how AdGuard Home works:

  • To acquire the IP address of a domain, your computer sends a DNS request (,, etc.).
  • If it’s not banned (, AdGuard Home will either respond or block traffic to sites that house advertisements or viruses (

As a result, you must first instruct your computer to utilize AdGuard Home as its default DNS server. The instructions are available during the welcome process or by selecting “Setup Guide” from the online interface:1641359689_983_Getting-Started-With-AdGuard-Home-On-Raspberry-Pi-vs-Pi-Hole

I suggest starting with only one device. If your computer is running Windows, for example, go to Control Panel, Network and Internet settings, and change the DNS server for your current connection. It looks like this in Windows 11:1641359689_901_Getting-Started-With-AdGuard-Home-On-Raspberry-Pi-vs-Pi-Hole

You may then perform the same thing on any device if it’s operating well and isn’t blocking too much. However, changing your router setup to utilize the Raspberry Pi as the primary DNS server is the simplest approach to acquire a network-wide ad-blocker. Any device connected to your network will go through AdGuard Home in this manner.

Just make sure you don’t turn your Raspberry Pi off after that, otherwise everyone will lose Internet access:-).

Additional Configuration


Today’s sale on Master Python on Raspberry Pi is 10% off. Get your hands on the eBook. Make the most of your Raspberry Pi by learning new ideas and using shortcuts. If you don’t know Python, you’ll lose out on half of the pleasure of using a Raspberry Pi.

The UI is then rather self-explanatory, so I won’t spend too much time here, but here’s a brief rundown:

  • Dashboard: This is the first page you see when you log in. You’ll get a good idea of what AdGuard Home has been up to (DNS queries handled, and blocked). You’ll also be able to examine the most popular websites and clientele. On top, there’s a “Deactivate Protection” button that lets you temporarily disable everything (for example, to check if an issue you experience is due to AdGuard Home or not).
  • Settings:
    • Default settings: Configuration at its most basic. If you wish to activate parental control or safe search, I believe you’ll utilize it. Apart than that, the normal settings should suffice. Also, make sure you have authorization to preserve the logs for 90 days if you’re utilizing it in a corporation.
    • DNS settings: By default, AdGuard Home utilizes Quad9 as its primary DNS server. If you wish, you may update it or add additional failover options.
    • Encryption options: Not the most practical for home use. However, it’s comforting to know that everything can be readily set from there. You may also alter the default ports on this page to prevent conflicts (for example, if you host another web server or DNS server on the same Raspberry Pi).
    • Client settings: Depending on the client, you may change the setup a little differently. For instance, you could want to allow parental control on your daughter’s phone but not on the rest of her gadgets.
    • DHCP settings: If you wish to utilize AdGuard Home as your DHCP server, you may do so right from the settings page.
  • Filters: Select the blocklists you want to use and, if necessary, add some exclusions. Updates are carried out automatically.
  • Query log: This is where you’ll locate all of your requests and see what happened to each of them. It’s ideal for debugging. From there, you can also ban and unblock domains.

If you need more technical information on how to perform anything particular, I strongly suggest consulting the official Wiki. You may also address your queries to their GitHub repository.

AdGuard Home vs. Pi-Hole: What’s the Difference?

Take a look at my cheat sheet! Get your free PDF file with all the Raspberry Pi instructions you’ll ever need!

Both systems, in general, function in the same manner, preventing advertisements and trackers for customers. There are a few minor differences, such as the default DNS servers (Quad9 versus Google) and built-in technologies. AdGuard Home seems to be more up-to-date and user-friendly than Pi-Hole.

First impressions are important.

For the end-user, as I said in the start, there isn’t much of a difference. You’ve got your Raspberry Pi running a DNS server, and you’ve set up your client or router to utilize it. After that, a large majority of advertising will be banned, and you’ll have access to a web interface to understand what went wrong and adjust the settings.

I didn’t use AdGuard Home long enough to give you a thorough evaluation, but there are a few noteworthy features:

  • Pi-Hole has the quickest installation: both are simple to set up, but Pi-Hole installs a lot more during the installation process.
  • Cleaner interface: The Pi-Hole interface is starting to seem a little dated. I believe it was never updated. Furthermore, when you first use their UI, it might be a little intimidating.
  • Different technologies: I’m no expert, but it seems like AdGuard Home has a leg up on the competition in terms of technology (written in Go, HTTPS UI, DNS through HTTPS/TLS, and so on). This is critical for that kind of program, in my opinion.
  • It’s possible that the configuration is limited: That’s how it usually goes. It’s either intuitive (Retropie vs. Recalbox) or comprehensive (Retropie vs. Recalbox). I’m not sure whether you can go as deep with the setup specifics as you can with Pi-Hole. Is it, however, really necessary?

At the very least, I’m persuaded enough to give it another go, replacing Pi-Hole with AdGuard Home for a time to see how things go. If my opinion changes, I will update this article. But, for the time being, I propose that you do the same. Check it out for a few days/weeks to see how it works.

Table of Contents: AdGuard Home vs. Pi-Hole

Feature AdGuard Home Pi-Hole
Installation Easy. A few moments. Easy. A few moments.
Web-based user interface Yes. Modern and user-friendly. Yes. It was a little overwhelming (too many menus and options).
Cross-platform Yes Docker is the only way to go.
Search engines should be forced to do safe searches. Yes No
Parental authority Yes No
Phishing and virus sites are blocked. Yes You must add a particular blocklist if you want it to work.
The web interface is secured by HTTPS. Yes You can set it up in Lighttpd.
DNS via HTTPS is secure. Yes By default, no.
Ads on YouTube, Instagram, Facebook, and other sites are blocked. No No

If you’d want to learn more about Pi-Hole and compare it to AdGuard Home, I’ve written a comprehensive post on the subject: Pi-Hole must be installed on the Raspberry Pi (Free Ad Blocker in 15min).

Resources for the Raspberry Pi

Don’t know where to begin? Learn all there is to know about the Raspberry Pi, stop looking for assistance all the time, and start enjoying your projects. Now is the time to watch the Raspberry Pi Bootcamp course.

In only 30 days, you’ll have mastered the Raspberry Pi. You don’t want just the basics? This book is for you if you want to learn the best ways to become a Raspberry Pi expert. With step-by-step instructions, you may learn important Linux skills and perform a variety of tasks. Take a look at the e-book.

VIP Members’ Club You may also join the Patreon community if you simply want to hang out with me and show your support. I provide you early access to my stuff and share behind-the-scenes information there. When you join, you’ll also receive a shoutout. More information may be found here. Do you need assistance building anything using Python? Any Python script for your Raspberry Pi may be created, understood, and improved. Learn the basics in a step-by-step manner, rather than wasting time on irrelevant ideas. Now is the time to get the e-book.

This website also contains all of my tool and hardware suggestions.

Watch This Video-

The “adguard home setup guide” is a guide that will help you get started with AdGuard Home on Raspberry Pi. The guide includes the installation process and all of the necessary steps to install it.

Frequently Asked Questions

How does AdGuard home compare to Pi-hole?

A: AdGuard home is a free, open-source adblocker for your browser. It blocks advertisements with HTTPS requests and lets users whitelist only the websites they want to see ads on. Pi-hole is a tool that filters out most of an internet users traffic from their network by blocking all outgoing connections except those originating at the web server itself.

How do I install AdGuard home on pi?

A: You can first use the AdGuard apk to install it on your device, then download and extract this file, as well as execute it.

How do I set up AdGuard home?

A: To set the app as your default browser and have AdGuard block ads on all websites, you need to follow these steps. These are for Windows but should be similar for other operating systems.
1) Click Start
2) Open the search bar by pressing Ctrl+F or clicking in the top left corner of window where it says Search
3) Type advanced settings into that field
4) You will now see a page with quite a few options; click Application Settings, then change Default Browser to (it might say something different if youre using another browser). Thats it!

Related Tags

  • adguard home raspberry pi 4
  • adguard home raspberry pi install
  • adguard home block youtube ads
  • install adguard home raspberry pi zero
  • adguard home raspberry pi zero w