Home - Asuswrt-Merlin/asuswrt-merlin.ng GitHub Wiki

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 - 386.x (External link)
  7. Changelog - 3004 (388.x and newer) (External link)
  8. Changelog - 3006 (102.x and newer) (External link)
  9. Installation
  10. Reverting

Usage

  1. User scripts
  2. JFFS
  3. Customizing configuration files
  4. DDNS Services
  5. Custom DDNS support
  6. SSH
  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 Director
  14. Using a custom webui/FTP SSL certificate
  15. DNS Privacy (DNS-over-TLS)
  16. AiMesh
  17. AMTM - Asuswrt-Merlin Terminal Menu
  18. Policy-based routing through VPN Director

OpenVPN

  1. About OpenVPN
  2. Setting up OpenVPN
  3. Generating certs with Easy-RSA
  4. Policy-based routing (Before version 386.3)
  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. Installing Transmission through Entware
  3. Lighttpd web server with PHP support through Entware
  4. Installing RTorrent through Entware (External link)
  5. Installing Deluge through Entware
  6. Webcam video surveillance Entware (External link)

Chroot Debian

  1. Plex Media Server on Arm Routers (External link, Accessed by The Wayback Machine)
  2. Plex Media Server on Armhf (RT-AX58U etc.) Routers (External link, accessed by the The Wayback Machine)
  3. Debian 12 Bookworm + Plex Media Server (Asus RT-AX86S) (External link)* *the most up-to-date guide, written for Arm64 routers, but works for Armhf too, just change to your processor architecture when installing debian through debootstrap)
  4. Minidlna Upnp Media Server through debian (link list)

Development

  1. Download the latest source code from GitHub
  2. Compile from source
  3. Setting up a virtual machine for building:
    1. Setting up a build VM under WSL2
    2. Setting up a build VM under Multipass
    3. Setting up a build environment in Docker
  4. Addons API

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
  15. Installing Tailscale through Entware

Misc HowTo and Guides

  1. Email notification from your router
  2. WOL Script Wake Up Your Webserver On Internet Traffic
  3. How to make a NTFS usb hdd running more stable as media server, by ChrisR
  4. Network Image Scanning With Sane
  5. Delay start of minidlna to wait for the USB disk mount
  6. Setting-up-FreeRadius2-through-Entware
  7. User NVRAM Save/Restore
  8. Transfer (sync) a backup to a remote location using Rsync through a SSH tunnel between 2 Asus routers
  9. Setting a random password for guest wifi
  10. Guest WIFI QR code generator for display on local network webpage (visible from TV, smartphones...) and random password rotation
  11. Tinc VPN on AsusWRT-Merlin (External Link)
  12. LUKS Encrypted USB Drive HOWTO
  13. USB Disk Check at Boot
  14. USB Disk Check at Boot or Hot Plug (improved version)
  15. Minidlna - Common Issues & Solutions
  16. pyTivo - How-To Guide
  17. Disk formatting
  18. Change the webui language
  19. Restart WAN interface when internet is down
  20. Installing and running openSSH on Merlin
  21. Enable PXE booting into netboot.xyz

Reference:

  1. FAQ
  2. Credits
  3. Contact
  4. Disclaimer
  5. Privacy
⚠️ **GitHub.com Fallback** ⚠️