Install AdGuard on a Raspberry Pi | Ubuntu (2023)

Download the AdGuard image

Verify your download Run this command in your terminal in the directory the iso was downloaded to verify the SHA256 checksum:
echo "e6ce0e3485c8916ab3c1f820643fb1a69efc50380e72bbdc4f481a162b2eccf8 *adguard-home-core18-pi.img.xz" | shasum -a 256 --check
You should get the following output:
https://cdimage.ubuntu.com/ubuntu-core/appliances/adguard-home-core18-pi.img.xz: OK
Or follow this tutorial to learn how to verify downloads

Install AdGuard on a Raspberry Pi | Ubuntu (1)

Installation instructions

What you'll need

  • A microSD card (4GB minimum, 8GB recommended)
  • A Raspberry Pi 3 or 4
  • A computer with a microSD card drive
  • A micro-USB power cable (USB-C cable for the Pi 4)
  • A monitor with an HDMI interface
  • AHDMI cable for the Pi 3 and a MicroHDMI cable for the Pi 4
  • A USB keyboard

These steps will flash your AdGuard Ubuntu Appliance to your Raspberry Pi with a Ubuntu machine, and get you logged in.

  1. Install the Raspberry Pi Imaging Tool

    Download the Imaging Tool for Ubuntu

  2. Prepare the microSD card

    Warning

    This will completely erase the microSD card.

    • Insert the microSD card into your computer
    • Run the imager and click CHOOSE OS
    • Next, choose Use Custom. Select the image you downloaded.
    • Select your microSD card and click WRITE.

    While it is preparing the disk you can go on to the next step and create your SSH keys for secure access to the appliance.

  3. Generate Secure Shell (SSH) keys

    The 'Secure Shell' protocol provides access to your Ubuntu Appliance and uses cryptographic keys to authenticate you to the device. You need SSH software and keys.

    Run the following command:

    ssh-keygen -t rsa
    1. This starts the key generation process. When you execute this command, the ssh-keygen utility prompts you to indicate where to store the key
    2. Press the ENTER key to accept the default location. The ssh-keygen utility prompts you for a passphrase
    3. Type in a passphrase

    You now have a public and private key that you can use to authenticate.

  4. Create an Ubuntu SSO account

    Your Ubuntu Appliance will be added to your Ubuntu cloud account and use your SSH keys to identify you. Add your keys to your account at https://login.ubuntu.com/ssh-keys.

    To do so, run the following command in your terminal.

    cat ~/.ssh/id_rsa.pub

    (Video) AdGuard Home installieren und einrichten. Werbefrei surfen! FritzBox einrichten.

    Copy the result into the text field on the website. Click import and will have the key set up.

  5. Boot your Raspberry Pi from the microSD card

    Wait for the Raspberry Pi images to complete. Remove the microSD card from your computer and insert it into the Raspberry Pi. Attach your monitor and keyboard to the Pi, you will use them for the initial device configuration.

    If you want to use a wired network, connect your ethernet cable to the Pi before booting.

    Power up the Pi by connecting it to your USB power supply.

    Your Pi will boot, and present you with a series of configuration choices. You need to ensure that the Pi has internet access so that it can get updates and verify your SSH keys. If you need more help there is a tutorial that goes through these steps in more detail.

    Next, you will need to enter your Ubuntu cloud account email address. Your Pi will connect to your cloud account and retrieve your SSH keys.

  6. SSH in

    Your Pi will show an ssh command like:

    ssh <Ubuntu SSO user name>@<device IP address>

    Your user name is your Ubuntu SSO user name.

    Your terminal will welcome you to Ubuntu Core.

  7. That's it

    Now that you're in your Pi you will be able to use your AdGuard Ubuntu Appliance image.

What you'll need

  • A microSD card (4GB minimum, 8GB recommended)
  • A Raspberry Pi 3 or 4
  • A computer with a microSD card drive
  • A micro-USB power cable (USB-C cable for the Pi 4)
  • A monitor with an HDMI interface
  • AHDMI cable for the Pi 3 and a MicroHDMI cable for the Pi 4
  • A USB keyboard

These steps will flash your AdGuard Ubuntu Appliance to your Raspberry Pi with a Windows machine, and get you logged in.

  1. Install the Raspberry Pi Imaging Tool

    Download the Imaging Tool for Windows

  2. Prepare the microSD card

    Warning

    This will completely erase the microSD card.

    • Insert the microSD card into your computer
    • Run the imager and click CHOOSE OS
    • Next, choose Use Custom. Select the image you downloaded.
    • Select your microSD card and click WRITE.

    While it is preparing the disk you can go on to the next step and create your SSH keys for secure access to the appliance.

  3. Install OpenSSH

    The 'Secure Shell' protocol provides access to your Ubuntu Appliance and uses cryptographic keys to authenticate you to the device. You will need SSH software and keys.

    (Video) How to Setup AdGuard Home on a Raspberry Pi!

    Some versions of Windows 10 include an SSH client already, but if yours does not or you're unsure, follow these steps to install one.

    1. OpenSSH client is an installable feature of Windows 10.

      To install OpenSSH, start Settings then go to Apps > Apps and Features > Manage Optional Features.

    2. Scan this list to see if OpenSSH client is already installed. If not, at the top of the page select Add a feature, then, to install the OpenSSH client, locate OpenSSH Client and click Install

      Once the installation completes, return to Apps > Apps and Features > Manage Optional Features and you should see the OpenSSH component(s) listed.

    To install OpenSSH using PowerShell, first launch PowerShell as an Administrator. To make sure that the OpenSSH features are available for install type the command:

    Get-WindowsCapability -Online | ? Name -like 'OpenSSH*'

    This should return:

    Name : OpenSSH.Client~~~~0.0.1.0State : NotPresent

    Then, install the client features:

    Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

    Both commands should return:

    Path :Online : TrueRestartNeeded : False
  4. Generate Secure Shell (SSH) keys

    After you have installed OpenSSH client you will need to generate user SSH keys to secure the connection to your Raspberry Pi.

    Launch 'Windows PowerShell' as an Administrator, and type:

    ssh-keygen

  5. Create an Ubuntu SSO account

    Your Ubuntu Appliance will be added to your Ubuntu cloud account and use your SSH keys to identify you. Add your keys to your account at https://login.ubuntu.com/ssh-keys.

    To do so, run the following command in your terminal, which will copy your public key to your keyboard.

    type ~\.ssh\id_rsa.pub | clip.exe

    You can then paste your key result into the text field on your Ubuntu One account. Click import and will have the key set up.

  6. Boot your Raspberry Pi from the microSD card

    Wait for the Raspberry Pi images to complete. Remove the microSD card from your computer and insert it into the Raspberry Pi. Attach your monitor and keyboard to the Pi, you will use them for the initial device configuration.

    If you want to use a wired network, connect your ethernet cable to the Pi before booting.

    Power up the Pi by connecting it to your USB power supply.

    Your Pi will boot, and present you with a series of configuration choices. You need to ensure that the Pi has internet access so that it can get updates and verify your SSH keys. If you need more help there is a tutorial that goes through these steps in more detail.

    Next, you will need to enter your Ubuntu cloud account email address. Your Pi will connect to your cloud account and retrieve your SSH keys.

  7. SSH in

    Your Pi will show an ssh command like:

    ssh <Ubuntu SSO user name>@<device IP address>

    Your user name is your Ubuntu SSO user name.

    Your terminal will welcome you to Ubuntu Core.

    (Video) AdGuard Home auf einen Raspberry PI installieren
  8. That's it

    Now that you're in your Pi you will be able to use your AdGuard Ubuntu Appliance image.

What you'll need

  • A microSD card (4GB minimum, 8GB recommended)
  • A Raspberry Pi 3 or 4
  • A computer with a microSD card drive
  • A micro-USB power cable (USB-C cable for the Pi 4)
  • A monitor with an HDMI interface
  • AHDMI cable for the Pi 3 and a MicroHDMI cable for the Pi 4
  • A USB keyboard

These steps will flash your AdGuard Ubuntu Appliance to your Raspberry Pi with a macOS machine, and get you logged in.

  1. Install the Raspberry Pi Imaging Tool

    Download the Imaging Tool for macOS

  2. Prepare the microSD card

    Warning

    This will completely erase the microSD card.

    • Insert the microSD card into your computer
    • Run the imager and click CHOOSE OS
    • Next, choose Use Custom. Select the image you downloaded.
    • Select your microSD card and click WRITE.

    While it is preparing the disk you can go on to the next step and create your SSH keys for secure access to the appliance.

  3. Generate Secure Shell (SSH) keys

    The 'Secure Shell' protocol provides access to your Ubuntu Appliance and uses cryptographic keys to authenticate you to the device. You will need SSH software and keys.

    Terminal is the terminal emulator which provides a text-based command-line interface (CLI) to the Unix shell of macOS.

    To open the macOS Terminal:

    1. In Finder, select Utilities from the Applications folder.
    2. Find Terminal in the utilities list.
    3. Enter the following command:

      ssh-keygen -t rsa

      This starts the key generation process. When you execute this command, the ssh-keygen utility prompts you to indicate where to store the key

    4. Press the ENTER key to accept the default location. The ssh-keygen utility prompts you for a passphrase
    5. Type in a passphrase

    You now have a public and private key that you can use to authenticate.

    Your private key is saved to the id_rsa file in the .ssh directory and is used to verify the public key you use belongs to the same account.

  4. Create an Ubuntu SSO account

    Your Ubuntu Appliance will be added to your Ubuntu cloud account and use your SSH keys to identify you. Add your keys to your account at https://login.ubuntu.com/ssh-keys.

    (Video) AdGuard Home & DietPi: Schritt für Schritt Installation auf Raspberry Pi Zero 2W

    To do so, run the following command in your terminal.

    cat ~/.ssh/id_rsa.pub

    Copy the result into the text field on the website. Click import and will have the key set up.

  5. Boot your Raspberry Pi from the microSD card

    Wait for the Raspberry Pi images to complete. Remove the microSD card from your computer and insert it into the Raspberry Pi. Attach your monitor and keyboard to the Pi, you will use them for the initial device configuration.

    If you want to use a wired network, connect your ethernet cable to the Pi before booting.

    Power up the Pi by connecting it to your USB power supply.

    Your Pi will boot, and present you with a series of configuration choices. You need to ensure that the Pi has internet access so that it can get updates and verify your SSH keys. If you need more help there is a tutorial that goes through these steps in more detail.

    Next, you will need to enter your Ubuntu cloud account email address. Your Pi will connect to your cloud account and retrieve your SSH keys.

  6. SSH in

    Your Pi will show an ssh command like:

    ssh <Ubuntu SSO user name>@<device IP address>

    Your user name is your Ubuntu SSO user name.

    Your terminal will welcome you to Ubuntu Core.

  7. That's it

    Now that you're in your Pi you will be able to use your AdGuard Ubuntu Appliance image.

Start using your AdGuard Ubuntu Appliance

Now you can go ahead and set everything up. It's usually best to wait 5-10 minutes here. Some snaps will need to refresh themselves and the appliance may need to automatically reboot. When you're ready go to:

http://<IP-of-your-appliance>:3000

in another computers browser. Where you will find the initial configuration wizard.

Follow the instructions to start using your new Adguard Home Ubuntu Appliance.

On the AdGuard configuration screen, under DNS Server, it will have an error in red: listen udp 0.0.0.0:53: bind: address already in use. Change the listen interface to Eth0.

Once you've finished the AdGuard configuration, you can connect to the admin panel by just going to http://<ip address> (no longer port 3000), and can configure other devices on your network to use that ip address for the DNS server.

For more information or more documentation on what to do now, the AdGuard website is the best place to go next.

FAQs

Is AdGuard better than pi hole? ›

While it's easy to create a simple adversarial comparison of "Pi-Hole vs. AdGuard Home", I believe that has been done 10 times over. The short answer is they are nearly exactly the same, and use effectively the same method for blocking ads, trackers, and bad websites.

How do I update my Raspberry Pi AdGuard? ›

We have a detailed guide on manual updates, but in short:
  1. Download the new AdGuard Home package.
  2. Unpack it to a temporary directory.
  3. Replace the old AdGuard Home executable file with the new one.
  4. Restart AdGuard Home.
6 Sept 2022

Does AdGuard work on Linux? ›

AdGuard Home | Network-wide software for any OS: Windows, macOS, Linux.

Do you have to pay for AdGuard home? ›

If you're looking for a network-wide solution for ad-blocking and reducing the amount of tracking online, AdGuard Home is a free and open-source solution that you can use. The software is open source and can be self-hosted on an inexpensive device to both buy and run such as the Raspberry Pi.

What is the DNS for AdGuard? ›

AdGuard DNS. AdGuard DNS is an alternative solution for tracker blocking, privacy protection, and parental control. Easy to set up and free to use, it provides a necessary minimum of best protection against online ads, trackers, and phishing, no matter what platform and device you use.

Is AdGuard Russian? ›

AdGuard Software Limited was founded in 2009 in Moscow. In 2014 AdGuard Software Limited's products became available in Cyprus to where its headquarters were subsequently moved.

Is there something better than Pi-hole? ›

Beats, Wireshark, LibreNMS, PRTG, and Riemann are the most popular alternatives and competitors to Pi-hole.

Is uBlock Origin better than AdGuard? ›

uBlock is much more efficient in resource usage, meaning it runs faster than AdGuard. Moreover, uBlock is an open-source software. To any privacy-conscious person, this is a massive plus. On the other hand, AdGuard offers more features and has more versatility.

How do I set up AdGuard? ›

Instructions for Android 9 and above
  1. Go to Settings → Network & Internet (or Wi-Fi & Internet)
  2. Select Advanced → Private DNS.
  3. Select Private DNS provider hostname. Enter one of the servers below: Default server. dns.adguard-dns.com. AdGuard DNS will block ads and trackers. Non-filtering server. unfiltered.adguard-dns.com.

Is AdGuard home open-source? ›

AdGuard Home is a network-wide, open source software for blocking ads & tracking and for gaining control over all traffic in your home network. After you set it up, it'll cover ALL devices in your home Wi-Fi network, and you won't need any client-side software for that.

Is AdGuard home safe? ›

It's based on the same software that powers AdGuard DNS servers; they share a lot of code. AdGuard Home is a quick and simple way to block ads on any device and keep your children safe online. AdGuard Home is also a very respectful application to your privacy.

Is AdGuard any good? ›

AdGuard does a great job of protecting you on three fronts: blocking most ads (popups and embedded ads), most trackers and most malicious websites. It manages to do this in a much more unobtrusive way than many other similar apps, programs and browser extensions I've tried.

Is AdGuard worth? ›

Sometimes, however, ads and viruses are one in the same. So, you'll still need an anti-malware application to rid your computer of nasty threats. But Adguard will still help filter malicious scripts from infecting your computer in the first place. As they say, an ounce of prevention is worth a pound of cure.

Is AdGuard for free? ›

AdGuard Browser extension for Chrome is a free ad blocker that removes ads and trackers in this browser.

How do I set up AdGuard? ›

Instructions for Android 9 and above
  1. Go to Settings → Network & Internet (or Wi-Fi & Internet)
  2. Select Advanced → Private DNS.
  3. Select Private DNS provider hostname. Enter one of the servers below: Default server. dns.adguard-dns.com. AdGuard DNS will block ads and trackers. Non-filtering server. unfiltered.adguard-dns.com.

How do I access AdGuard? ›

To login to AdGuard Home, you will need to enter the username and password you set when going through the initial setup steps (1.). Once you have entered your details, click the “ Sign in ” button to proceed. 3. You will now have full access to the AdGuard Home dashboard and all of its settings.

How do I set up AdGuard home assistant? ›

Configuration
  1. Browse to your Home Assistant instance.
  2. In the sidebar click on Settings.
  3. From the configuration menu select: Devices & Services.
  4. In the bottom right, click on the Add Integration button.
  5. From the list, search and select “AdGuard Home”.
  6. Follow the instruction on screen to complete the set up.

How do I enable SSH on Raspbian? ›

By default, SSH is disabled on the Raspberry Pi. It is however very easy to enable it, both using the Desktop and via the terminal. To enable SSH via the Desktop, go to the start menu > Preferences > Raspberry Pi Configuration . Now click on Interfaces and click enable next to SSH and click OK .

Videos

1. AdGuard Home mit DietPi auf einem Raspberry 4 installieren - WERBUNG ! Nein Danke 😎 #adguard
(Jochen Moll Videographer)
2. Raspberry Pi Firewall installieren für AdGuard
(Secure Bits)
3. AdGuard | Blocking AD's Using A Raspberry Pi Using AdGuard Home
(Fuzz The Pi Guy)
4. AdGuard Home on Raspberry Pi for All Models
(PcMac)
5. Raspberry Pi Home Server Episode 12: Install AdGuard Home with MacVLAN
(DB Tech)
6. Block Ads On Every Device! - AdGuard Home on Raspberry Pi
(ShaneAJM)
Top Articles
Latest Posts
Article information

Author: Duane Harber

Last Updated: 08/06/2023

Views: 5958

Rating: 4 / 5 (51 voted)

Reviews: 82% of readers found this page helpful

Author information

Name: Duane Harber

Birthday: 1999-10-17

Address: Apt. 404 9899 Magnolia Roads, Port Royceville, ID 78186

Phone: +186911129794335

Job: Human Hospitality Planner

Hobby: Listening to music, Orienteering, Knapping, Dance, Mountain biking, Fishing, Pottery

Introduction: My name is Duane Harber, I am a modern, clever, handsome, fair, agreeable, inexpensive, beautiful person who loves writing and wants to share my knowledge and understanding with you.