Mirrored_Repos/unifios-utilities
1
0
Fork 0
mirror of https://github.com/unifi-utilities/unifios-utilities.git synced 2024-08-30 18:32:21 +00:00
Code Issues Packages Projects Releases Wiki Activity

improve the docs for AdGuardHome (#135)

Browse Source 
* AdGuardHome: fix order of operations

Fix the initial order of operations that causes initial setup issues.
fixes #107.

* AdGuardHome: clean up some info with formatting

* AdGuardHome: add troubleshooting info

Hopefully this will help folks in #107 solve their issues.

* 10-dns: always write out the symlinks

Skip spitting an error about the fact that the symlinks already exist.
Just write them anyway.
This commit is contained in:
Doug Goldstein 2021-03-18 15:25:17 -05:00 committed by GitHub
parent d495b41056
commit 2bd42cdc7d
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 24 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
AdguardHome/README.md
View File

@ -19,9 +19,9 @@
## Steps ## Steps
1. On your controller, make a Corporate network with no DHCP server and give it a VLAN. For this example we are using VLAN 5. 1. On your controller, make a Corporate network with no DHCP server and give it a VLAN. For this example we are using VLAN 5.
1. Copy [10-dns.sh](../dns-common/on_boot.d/10-dns.sh) to /mnt/data/on_boot.d and update its values to reflect your environment 1. Copy [10-dns.sh](../dns-common/on_boot.d/10-dns.sh) to `/mnt/data/on_boot.d` and update its values to reflect your environment
1. Execute /mnt/data/on_boot.d/10-dns.sh 1. Copy [20-dns.conflist](../cni-plugins/20-dns.conflist) to `/mnt/data/podman/cni` after generating a MAC address. This will create your podman macvlan network.
1. Copy [20-dns.conflist](../cni-plugins/20-dns.conflist) to /mnt/data/podman/cni. This will create your podman macvlan network 1. Execute `/mnt/data/on_boot.d/10-dns.sh`
1. 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. 1. 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.
```shell script ```shell script
@ -40,3 +40,23 @@
1. Browse to 10.0.5.3:3000 and follow the setup wizard 1. Browse to 10.0.5.3:3000 and follow the setup wizard
1. Update your DNS Servers to 10.0.5.3 (or your custom ip) in all your DHCP configs. 1. Update your DNS Servers to 10.0.5.3 (or your custom ip) in all your DHCP configs.
1. Access the AdguardHome like you would normally. 1. Access the AdguardHome like you would normally.
## Troubleshooting
If you get the following error:
```
Error adding network: failed to create macvlan: cannot assign requested address
```
When starting the container then the MAC address you generated is not good. You can cheat at this point and look at the address of `br$VLAN.mac` with `ifconfig br$VLAN.mac` and use that value.
To start over you must remove the container and the macvlan device:
```
podman container rm adguardhome
podman network rm dns -f # expect an error here
ip link delete br$VLAN.mac
```
You can now run `10-dns.sh` again and start the container again.

2
dns-common/on_boot.d/10-dns.sh
View File

@ -41,7 +41,7 @@ ln -s $CNI_PATH /opt/cni/bin
for file in "$CNI_PATH"/*.conflist for file in "$CNI_PATH"/*.conflist
do do
if [ -f "$file" ]; then if [ -f "$file" ]; then
ln -s "$file" "/etc/cni/net.d/$(basename "$file")" ln -fs "$file" "/etc/cni/net.d/$(basename "$file")"
fi fi
done done