aboutsummaryrefslogtreecommitdiff
path: root/posts/adguard.md
blob: f896f6fe7056f28275c6ddc2af1b9fb481cbe5eb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
# Setting Up AdGuard Home with Eero

2022-11-04

Eariler this year I posted [detailed instructions on setting up Pi-Hole with Eero](/eero) and it seemed to help out a few people having troubles. With AdGuard Home recently popping up on the [frontpage of HackerNews](https://news.ycombinator.com/item?id=33387678), I thought now would be a great time to post instructions of setting up *that* service alongside Eero devices.

## What You'll Need

1. Raspberry Pi device (I recommend the Pi Zero for simplicity and low cost)
2. microSD card
3. [Raspberry Pi Imager](https://www.raspberrypi.com/software/)
3. micro USB to ethernet adapter (check your local Amazon)
4. Patience!

## Setting Up the Raspberry Pi

The first thing we need to do is flash Raspberry Pi **Lite** onto our SD card. Open Raspberry Pi Imager, select the **Lite** version of the OS and your respective media (the SD card):

![Raspberry Pi Lite](/public/images/rpi-lite-os.webp)

Don't flash anything just yet! Be sure to use the gear icon and edit the settings. Set a custom hostname, enable `ssh` and setup a proper user:

![Imager settings](/public/images/rpi-adguard-1.webp)

## Plug it in and Boot!

Put the SD card into your Pi, connect power and ethernet. Give it a bit of time to boot up. Once you see a nice solid green LED, go back to your local computer's terminal and enter the following command:

```
ssh piguard@piguard.local
```

If everything was set up properly you will be asked to trust this device. Next, you will be prompted to enter the device password you setup.

Once you are connected directly to the Pi, it's best to check for updates:


    sudo apt update


...and if updates are in fact available, install them via:


    sudo apt upgrade


## Installing AdGuard Home

Simply run the automated installer:


    curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v


Follow the instructions and you'll be setup in no time! To view your AdGuard dashboard at any time, you can now simply navigate to `piguard.local`.

If you run into any issues, I strongly suggest [reading through the "Getting Started" guide](https://github.com/AdguardTeam/AdGuardHome#getting-started).

## Configuring the Eero App

Once your AdGuard Home server is installed and running, you can finally point your Eero network at it.

1. Open the Eero app (iOS or Android)
2. Navigate to **Settings** > **Network Settings** > **DNS**
3. Select **Customized DNS** and enter both your saved IPv4 / IPv6 values (These can be found under the `Setup Guide` tab in the main AdGuard Dashboard)
4. Eero will prompt you to reboot your network - do it

After the system reboots everything *should* be working as intended!

## Closing Thoughts

I've personally switched over from Pi-Hole to AdGuard Home - it just feels more robust and the UI is significantly cleaner. Hopefully this helps others trying to do the same!