Run AdGuard Home - Cross Platform Pi Hole Alternative - in Docker

#AdGuard #AdBlocker #Docker

*** Updated 06/03/2023

Full steps can be found at https://i12bretro.github.io/tutorials/0429.html

What is AdGuard Home?

AdGuard Home is a network-wide software for blocking ads and tracking. After you set it up, it'll cover ALL your home devices, and you don't need any client-side software for that.

It operates as a DNS server that re-routes tracking domains to a “black hole”, thus preventing your devices from connecting to those servers. It's based on software we use for our public AdGuard DNS servers, and both share a lot of code. -https://github.com/AdguardTeam/AdguardHome

Installing Docker

1. Log into the Linux host and run the following commands in a terminal window

# update software respositories
sudo apt update
# install available software updates
sudo apt upgrade ‐y
# install prerequisites
sudo apt install apt‐transport‐https ca‐certificates curl gnupg2 software‐properties‐common ‐y
# add docker gpg key
curl ‐fsSL https://download.docker.com/linux/debian/gpg | sudo apt‐key add ‐
# add docker apt repository
sudo apt‐add‐repository "deb [arch=amd64] https://download.docker.com/linux/debian buster stable"
# install docker
sudo apt install docker ‐y
# add the current user to the docker group
sudo usermod ‐aG docker $USER
# reauthenticate for the new group membership to take effect
su ‐ $USER

Running AdGuard Home Container

1. Continue with the following commands in a terminal window

# make adguard working directories
mkdir ~/docker/adguard/work ‐p && mkdir ~/docker/adguard/conf ‐p
# run the adguardhome docker image
docker run ‐‐name adguardhome ‐v ~/docker/adguard/work:/opt/adguardhome/work ‐v ~/docker/adguard/conf:/opt/adguardhome/conf ‐p 53:53/tcp ‐p 53:53/udp ‐p 80:80/tcp ‐p 3000:3000/tcp ‐‐restart unless‐stopped ‐d adguard/adguardhome

2. Open a web browser and navigate to http://localhost:3000
3. Click the Get Started button
4. Set the Admin Web Interface and DNS Server network interfaces and ports > Click Next
5. Enter an admin username and password > Click Next
6. Click Next on page 4
7. Click Open Dashboard on the Congratutations page
8. Log in using the admin username and password created during the install
9. Welcome to AdGuardHome running as a Docker container

   Source: [https://github.com/AdguardTeam/AdGuardHome/wiki/Docker](https://github.com/AdguardTeam/AdGuardHome/wiki/Docker)

### Connect with me and others ###
★ Discord: https://discord.com/invite/EzenvmSHW8
★ Reddit: https://reddit.com/r/i12bretro
★ Twitter: https://twitter.com/i12bretro
...
https://www.youtube.com/watch?v=p4jBY4WvJ6w