Home

This is the official Wiki/documentation for Asuswrt-merlin, a custom firmware designed for Asus routers.

Note: As with any Wiki, this documentation is a constant work-in-progress. Most of the content is contributed by the community - anyone with a Github account can edit it.

About

1. About Asuswrt and Asuswrt-merlin
2. Features (External link)
3. Screenshots (External link)
4. Supported devices
5. Changelog - Legacy (380.x) (External link)
6. Changelog - Current (382.x and newer) (External link)
7. Installation
8. Reverting

Usage

1. User scripts
2. JFFS
3. Customizing configuration files
4. DDNS Services
5. Custom DDNS support
6. SSHD
7. Scheduled tasks (Cron jobs)
8. Enhanced traffic monitoring
9. Adjustable TCP/IP connection tracking setting
10. Mounting remote CIFS shares
11. Disk Spindown when idle
12. NFS Exports
13. DNS Filter
14. Using a custom webui/FTP SSL certificate
15. QoS Queue Disciplines (codel/fq_codel)
16. Wi-Fi Radar
17. DNS Privacy (DNS-over-TLS)
18. AiMesh
19. AMTM - Asuswrt-Merlin Terminal Menu

OpenVPN

1. About OpenVPN
2. Setting up OpenVPN
3. Generating certs with Easy-RSA
4. Policy-based routing
5. Policy-based routing - manual method v380.xx firmware or later now DEPRECATED
6. Policy-based Port (or MAC address) routing - manual method
7. Static ip for OpenVPN clients

External software repositories

Entware

1. Setting up Entware (Optware alternative)
2. Setting up Entware (External link)
3. Installing Transmission through Entware
4. Lighttpd web server with PHP support through Entware
5. Installing RTorrent through Entware (External link)
6. Installing Deluge through Entware
7. Webcam video surveillance Entware (External link)

Chroot Debian

1. Plex Media Server on Arm Routers (External link)
2. Minidlna Upnp Media Server through debian (link list)

Development

1. Download the latest source code from GitHub
2. Compile from source using Ubuntu
3. Compile from source using Linux Mint
4. Compiling from source using a Debian-based Linux Distribution
5. Apply patches to source files
6. Addons API
7. Setting up a build environment under WSL2

Networking HowTo and Guides

1. Iptables tricks and tips
2. How to use Adblock Plus filter subscriptions to provide advertisement filtering to devices
3. Secure DNS queries using DNSCrypt
4. Setting up an IPv6 tunnel through Hurricane Electric
5. How to dedicate SSID for VPN and SSID for regular ISP using OpenVPN
6. How to use ipset to block connections
7. Link Aggregation Setup
8. Access modem Web UI on WAN port (no script)
9. Enforce the use of Google Safesearch on your LAN
10. How to have dedicated DHCP options bind to a specific SSID?
11. Custom domains with dnsmasq
12. How to use Adblock using Pixelserv
13. How to block scanners, bots, malware, ransomware
14. Adaptive QoS Optimization

Misc HowTo and Guides

1. Scheduled Reboot
2. Email notification from your router
3. WOL Script Wake Up Your Webserver On Internet Traffic
4. Scheduled LED control
5. How to make a NTFS usb hdd running more stable as media server, by ChrisR
6. Network Image Scanning With Sane
7. Delay start of minidlna to wait for the USB disk mount
8. Setting-up-FreeRadius2-through-Entware
9. User NVRAM Save/Restore
10. Transfer (sync) a backup to a remote location using Rsync through a SSH tunnel between 2 Asus routers
11. Setting a random password for guest wifi
12. Tinc VPN on AsusWRT-Merlin (External Link)
13. LUKS Encrypted USB Drive HOWTO
14. USB Disk Check at Boot
15. USB Disk Check at Boot or Hot Plug (improved version)
16. Minidlna: Common Issues & Solutions
17. pyTivo: How-To Guide
18. Setting up a NTP Server for your LAN
19. Disk formatting
20. Change the webui language

Third Party Scripts and Utilities

1. amtm - the Asuswrt-Merlin Terminal Menu
2. Diversion - The Router Ad Blocker - maintained by thelonelycoder
3. Skynet - Router Firewall & Security Enhancements - maintained by Adamm
4. FlexQoS - Flexible QoS Enhancement Script for Adaptive QoS - maintained by dave14305
5. YazFi - enhanced AsusWRT-Merlin Guest WiFi inc. SSID <-> VPN Client - maintained by Jack Yaz
6. scribe - syslog-ng and logrotate installer - maintained by cmkelley
7. x3mRouting - Selective Routing for Asuswrt-Merlin Firmware - maintained by Xentrk
8. unbound Manager - (Manager/Installer utility for unbound - Recursive DNS Server) - maintained by Martineau
9. connmon - Internet connection monitoring - maintained by Jack Yaz
10. ntpMerlin - NTP Daemon for AsusWRT Merlin - maintained by Jack Yaz
11. scMerlin - service and script control menu for AsusWRT-Merlin - maintained by Jack Yaz
12. spdMerlin - Automated speedtests with graphs - maintained by Jack Yaz
13. uiDivStats - WebUI for Diversion statistics - maintained by Jack Yaz
14. uiScribe - Custom System Log page for "scribed" logs - maintained by Jack Yaz
15. Stubby DNS Installer - maintained by Xentrk and Adamm (partially deprecated due to native DoT support in newer firmware)
16. DNSCrypt - dnscrypt installer for asuswrt - maintained by bigeyes0x0
17. Entware - maintained by zyxmon & ryzhovau
18. Pixelserv-tls - A Better One-pixel Webserver for Adblock - maintained by kvic (beta support suspended)
19. USB disk check at boot - maintained by ColinTaylor, latenitetech, thelonelycoder
20. Format disk - maintained by thelonelycoder and ColinTaylor. Now supports creation of up to three partitions.

Reference:

1. FAQ
2. Credits
3. Contact
4. Disclaimer
5. Privacy