mirror of https://github.com/unifi-utilities/unifios-utilities.git synced 2024-08-30 18:32:21 +00:00

* Store install-cni-plugins.sh once

* Newlines in on-boot-script

* Update example on_boot.sh for directory

* Update README.md examples

* Store 20-dns.conflist once

* Add modularized nextdns config w/IPv6 support

* Make nextdns script more generic

* Use common setup script for each dns service

* Add missing newlines

* Readme updates and ipv6 support

* Readme updates and ipv6 support

* Final updates and Ipv6

Co-authored-by: exodious <exodious@users.noreply.github.com>

2020-06-28 06:02:50 -07:00

2.4 KiB

Raw Blame History

Run AdguardHome on your UDM

Features

Run AdguardHome on your UDM with a completely isolated network stack. This will not port conflict or be influenced by any changes on by Ubiquiti
Persists through reboots and firmware updates.

Requirements

You have setup the on boot script described here
AdguardHome persists through firmware updates as it will store the configuration in a folder (you need to create this). It needs 2 folders, a Work and Configuration folder. Please create the 2 folders in "/mnt/data/". In my example I created "AdguardHome-Confdir" and "AdguardHome-Workdir"
The on-boot script needs to be setup after firmware update of UDM. When on-boot script is recreated, everything should work.

Customization

Feel free to change 20-dns.conflist to change the IP address of the container.
Update 10-dns.sh with your own values
If you want IPv6 support use 20-dnsipv6.conflist and update 10-dns.sh with the IPv6 addresses. Also, please provide IPv6 servers to podman using --dns arguments.

Steps

On your controller, make a Corporate network with no DHCP server and give it a VLAN. For this example we are using VLAN 5.
Copy 10-dns.sh to /mnt/data/on_boot.d and update its values to reflect your environment
Execute /mnt/data/on_boot.d/10-dns.sh
Copy 20-dns.conflist to /mnt/data/podman/cni. This will create your podman macvlan network

Run the AdguardHome docker container, be sure to make the directories for your persistent AdguardHome configuration. They are mounted as volumes in the command below.

podman run -d --network dns --restart always  \
    --name adguardhome \
    -v "/mnt/data/AdguardHome-Confdir/:/opt/adguardhome/conf/" \
    -v "/mnt/data/AdguardHome-Workdir/:/opt/adguardhome/work/" \
    --dns=127.0.0.1 --dns=1.1.1.1 \
    --hostname adguardhome \
    adguard/adguardhome:arm64-latest

Browse to 10.0.5.3:3000 and follow the setup wizard
Update your DNS Servers to 10.0.5.3 (or your custom ip) in all your DHCP configs.
Access the AdguardHome like you would normally.

2.4 KiB Raw Blame History