Skip to content

jumpsmm7/Asuswrt-Merlin-AdGuardHome-Installer

Repository files navigation

image

Asuswrt-Merlin-AdGuardHome-Installer:

The Official Installer of AdGuardHome for Asuswrt-Merlin

Requirements:

  • ARM based ASUS routers that use Asuswrt-Merlin Firmware, and Entware Repository.
  • JFFS support and enabled.
  • REQUIRES ENTWARE(!) for package management, and a separate USB drive for storage -i.e. the same drive Entware is stored.
  • Entware must be fully up-to-date as well opkg update && opkg upgrade.
  • Minimum recommended to have a 2gb swap file. (up to 10gb can be made with AMTM).
  • Minimum supported firmware version is 384.11.
  • It is recommended to use a Router stronger than the RT-AC68U, even though the AdGuardHome can be used at a limited capacity on the RT-AC68U.

Incompatibilities:

  • No known issue, but may not be compatible with "some" doule-nat or dual-wan environments since AdGuardHome takes over DNSMASQ placement on port 53. DNSMASQ uses port 553 instead.

Current features:

  • AdGuardHome Network-wide ads & trackers blocking DNS server, with multiple dns protocol encryption, and other features.
  • Support ARM based routers
  • Redirect all DNS queries on your network to AdGuardHome if user chooses to use Merlin DNS Filter Option
  • Ability to update AdGuardHome without reinstalling/reconfiguring
  • Improved Installer/Update/Backup Functions.

AdGuardHome Supports Multiple Features:

Features

  • 94.140.14.140: plain DNS (over UDP).
  • tls://dns-unfiltered.adguard.com: encrypted DNS-over-TLS.
  • https://cloudflare-dns.com/dns-query: encrypted DNS-over-HTTPS.
  • quic://dns-unfiltered.adguard.com:784: experimental DNS-over-QUIC support.
  • tcp://1.1.1.1: plain DNS (over TCP).
  • sdns://...: DNS Stamps for DNSCrypt or DNS-over-HTTPS resolvers.
  • [/example.local/]1.1.1.1: DNS upstream for specific domains, see below. Upstream-DNS

This forum link will provide you with a link to more dns servers and instructional use: http://www.snbforums.com/threads/release-asuswrt-merlin-adguardhome-installer-amaghi.76506/post-735471 also, https://adguard-dns.io/kb/general/dns-providers/

Setting Up Your Routers Reverse DNS:

Lan

  • Under Lan DHCP page on Asuswrt-Merlin define a domain such as lan or some-domain like in the image above. Reverse-DNS
  • Define the appropriate rules inside the Private Reverse DNS Servers. The AdGuardHome Installer already does this, but the information is more for user personal education.

Best AdGuardHome Setup Guide:

For the Best AdGuardHome Setup Guide please refer to their wiki: https://github.com/AdguardTeam/AdGuardHome/wiki

AdGuardHome Developement:

For issues pertaining with AdGuardHome itself, please refer to this link: https://github.com/AdguardTeam/AdGuardHome/issues

Changelog:

https://github.com/jumpsmm7/Asuswrt-Merlin-AdGuardHome-Installer/commits/master

Install/Update/Reconfig/Uninstall:

Run this command from ssh shell and following the prompt for AdGuardHome:

curl -L -s -k -O https://raw.githubusercontent.com/jumpsmm7/Asuswrt-Merlin-AdGuardHome-Installer/master/installer && sh installer

Terminal commands to for AdGuardHome are:

/opt/etc/init.d/S99AdGuardHome {start|stop|restart|check|kill|reload}

or (recommended commands)

service {start|stop|restart|kill|reload}_AdGuardHome

How to check if it works:

Run this command in the ssh shell:

pidof AdGuardHome

will return a number.

or:

/opt/etc/init.d/S99AdGuardHome check

which will return

  Checking AdGuardHome...              alive.

How to report issue:

I need following directories and files:

/opt/etc/AdGuardHome
/opt/sbin/AdGuardHome
/opt/etc/init.d/S99AdGuardHome
/opt/etc/init.d/rc.func.AdGuardHome
/jffs/addons/AdGuardHome.d
/jffs/scripts/init-start
/jffs/scripts/dnsmasq.postconf
/jffs/scripts/services-stop
/jffs/scripts/service-event-end

One can use this command to create a tar archive of these files:

echo .config > exclude-files; tar -cvf AdGuardHome.tar -X exclude-files /opt/etc/AdGuardHome /opt/sbin/AdGuardHome /opt/etc/init.d/S99AdGuardHome /opt/etc/init.d/rc.func.AdGuardHome /jffs/addons/AdGuardHome.d /jffs/scripts/init-start /jffs/scripts/dnsmasq.postconf /jffs/scripts/services-stop /jffs/scripts/service-event-end; rm exclude-files

in current directory and send me the archive for debug. I also need following information:

  • Which dns server you selected during AdGuardHome installation
  • Which router you're using
  • Firmware and its version

How I made this:

Donate:

This script will always be open source and free to use under GPL-3.0 License, but if you want to support future development you can do so by Donating With PayPal or Buy me a coffee.