Alex Porras edited this page Jan 20, 2017 · 150 revisions
Clone this wiki locally

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

As with any Wiki, this documentation is a constant work-in-progress. If you have the time and the willingness to help with this Wiki, please let me know.


  1. About Asuswrt and Asuswrt-merlin
  2. Features (External link)
  3. Screenshots (External link)
  4. Supported devices
  5. Changelog (External link)
  6. Installation
  7. Reverting


  1. User scripts
  2. JFFS
  3. Customizing configuration files
  4. Custom DDNS support
  5. SSHD
  6. Scheduled tasks (Cron jobs)
  7. Enhanced traffic monitoring
  8. Adjustable TCP/IP connection tracking setting
  9. Mounting remote CIFS shares
  10. Disk Spindown when idle
  11. NFS Exports
  12. DNS Filter
  13. Layer7-based Netfilter module


  1. About OpenVPN
  2. Setting up OpenVPN
  3. Generating certs with Easy-RSA
  4. Policy-based routing
  5. Policy-based routing - manual method

External software repositories

  1. Setting up New Generation Optware (External link)
  2. Setting up Optware
  3. Setting up Entware (Optware alternative)
  4. Setting up New Generation Entware (External link)
  5. Installing Transmission through Optware
  6. Installing Transmission through Entware
  7. Cherokee Web Server (External link)
  8. PyLoad Download Manager through Optware (External link)
  9. Lighttpd web server with PHP support through Entware
  10. Minidlna Upnp Media Server through debian (link list)
  11. Installing RuTorrent through Entware (External link)
  12. Webcam video surveillance Optware (External link)
  13. Installing Deluge through Entware
  14. Webcam video surveillance Entware (External link)
  15. Plex Media Server on Arm Routers (External link)


  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

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 from Tor nodes or some countries
  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

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. How to update Dyndns to use VPN IP address
  7. Network Image Scanning With Sane
  8. Delay start of minidlna to wait for the USB disk mount
  9. Setting-up-FreeRadius2-through-Entware
  10. User NVRAM Save/Restore
  11. Transfer (sync) a backup to a remote location using Rsync through a SSH tunnel between 2 Asus routers
  12. Setting a random password for guest wifi
  13. Tinc VPN on AsusWRT-Merlin (External Link)
  14. LUKS Encrypted USB Drive HOWTO
  15. Disk Check at Boot
  16. Minidlna: Common Issues & Solutions
  17. pyTivo: How-To Guide


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