Asuswrt-Merlin Firmware: Complete Install, Features & Scripting Guide
Upgrading an ASUS router to **Asuswrt-Merlin** custom firmware unlocks enterprise capabilities while preserving proprietary Broadcom hardware NAT acceleration and official Trend Micro AiProtection. Unlike OpenWrt, Merlin maintains 100% stock wireless performance while introducing an OpenSSH server, JFFS shell scripting, native in-kernel WireGuard, and the Entware package manager for advanced utilities like YazFi guest VLAN isolation and Diversion ad-blocking.
- 100% Stock Hardware Acceleration: Merlin integrates official Broadcom binary blobs (CTF/Runner flow offloading), maintaining full multi-gigabit WAN routing and identical Wi-Fi speeds.
- JFFS Persistent Shell Scripting: Execute custom bash scripts at boot (
init-start,wan-start,nat-start,firewall-start) to inject customiptables/nftablesrules or overridednsmasq.conf. - YazFi Guest Wi-Fi Isolation: Isolates guest networks onto independent subnets with custom DNS servers, two-way firewall isolation from primary LAN, and dedicated VPN tunnel steering.
- Safe, Non-Destructive Flashing: Flashes directly through the stock ASUS web GUI as a standard
.wor.trxupdate file; reverting to factory firmware requires zero special recovery tools.
What Makes Asuswrt-Merlin Different from Stock ASUSWRT and OpenWrt
Unlike third-party firmware projects like OpenWrt or DD-WRT that replace the router's entire operating system from scratch, Asuswrt-Merlin takes a surgical approach. Developed by Eric Sauvageau (RMerlin), the firmware is an enhanced, hardened fork of ASUS's official GPL source code.
This design provides the best of both worlds:
- Broadcom Proprietary Acceleration Preserved: Broadcom Wi-Fi 6, 6E, and 7 wireless chipsets require proprietary closed-source binary drivers and Cut-Through Forwarding (CTF) hardware NAT engines. In OpenWrt, these chips run on reverse-engineered drivers that lack 5GHz/6GHz hardware acceleration. Merlin incorporates the exact official Broadcom binary modules, guaranteeing identical wireless throughput and 2.5GbE/10GbE WAN line rates.
- Fixing ASUS Stock Limitations: Stock ASUSWRT hides advanced networking controls, restricts SSH access, limits DHCP reservation tables, and prevents custom DNS configurations. Merlin exposes complete administrative control over
dnsmasq, provides cron scheduling, updates OpenVPN/OpenSSH to upstream stable versions, and includes custom thermal readouts for CPU and 2.4/5/6 GHz radio chips.
Supported Hardware Models & System Architecture
Asuswrt-Merlin focuses strictly on select high-performance ASUS routers built on 64-bit ARM Broadcom SoCs (BCM4908, BCM4912, BCM4916). Supported flagship models include:
- Wi-Fi 7 Flagships: RT-BE96U, GT-BE98 Pro (BCM4916 quad-core 2.6 GHz).
- Wi-Fi 6 & 6E Powerhouses: RT-AX86U Pro, GT-AX6000, RT-AX88U Pro, GT-AXE16000, GT-AX11000 Pro (BCM4912 quad-core 2.0 GHz).
- Mainstream Wi-Fi 6: RT-AX86U, RT-AX68U, RT-AX58U (v1 only).
Note on MediaTek ASUS Routers: Newer budget ASUS routers using MediaTek chips (such as RT-AX53U, RT-AX59U, or TUF-AX4200) are not supported by Merlin due to closed MediaTek GPL licensing constraints; for MediaTek hardware, pure OpenWrt is the recommended alternative.
The Power of JFFS Scripting & VPN Director
The crown jewel of Merlin firmware is the JFFS (Journaling Flash File System) partition, a writable storage area in the router's NAND flash that survives reboots and firmware updates. When JFFS custom scripts are enabled under Administration > System, the firmware calls user-created executable bash scripts at specific lifecycle stages:
/jffs/scripts/firewall-start: Executes immediately after the router builds its iptables/nftables firewall rules. Ideal for locking down IoT devices or creating custom port forwardings./jffs/scripts/nat-start: Runs after NAT rules are applied. Used for redirecting hardcoded smart TV DNS queries (port 53/853) to your local Pi-hole./jffs/configs/dnsmasq.conf.add: Appends custom directives to the local DNS and DHCP server (such as static domain overrides or local PTR records).
VPN Director: Merlin's built-in policy-based routing engine allows you to assign specific devices (by local IP or MAC address) or destination subnets to route exclusively through WireGuard or OpenVPN client tunnels while keeping gaming consoles on the low-latency unencrypted ISP WAN.
The Entware Package Ecosystem: YazFi, Diversion & Skynet
By connecting an inexpensive USB 3.0 flash drive formatted with ext4 to the router, you can install Entware—a modern software repository with over 2,500 precompiled Linux packages. Using the community terminal utility amtm (Asuswrt-Merlin Terminal Menu), you can install powerful add-ons in seconds:
- YazFi: Transforms ASUS's basic Guest Wi-Fi feature into isolated, multi-subnet VLANs. Assigns independent DHCP subnets (e.g.,
192.168.3.0/24) to Guest Wi-Fi SSIDs, completely isolates guests from your primary LAN, and routes guest traffic through a VPN tunnel if desired. - Diversion: A full-featured router-level ad-blocker using
dnsmasqand custom blocklists, eliminating tracking beacons and mobile ads across every device on your network without installing client apps. - Skynet: An enterprise-grade dynamic firewall script that downloads real-time IP blocklists (MalwareDomainList, FireHOL, Spamhaus) and drops inbound scans and outbound botnet communication at the packet level.
Asuswrt-Merlin vs Stock ASUSWRT vs OpenWrt Feature Matrix
| Feature / Metric | Stock ASUSWRT | Asuswrt-Merlin | OpenWrt |
|---|---|---|---|
| Base Operating System | Proprietary ASUS Linux | Enhanced ASUS GPL Fork | Modular FOSS Linux (musl) |
| Hardware NAT (CTF / Runner) | Active (100% Line Rate) | Active (100% Line Rate) | Software Flow Offloading |
| Broadcom Wi-Fi Drivers | Official Proprietary Blobs | Official Proprietary Blobs | Reverse-Engineered (Limited) |
| Trend Micro AiProtection | Included (Free Lifetime) | Included (Free Lifetime) | Not Supported |
| SSH & Terminal Access | Basic Dropbear Shell | Full OpenSSH (Key Auth) | Full OpenSSH / Dropbear |
| JFFS Lifecycle Scripting | Disabled / Unsupported | Fully Supported (Bash) | Full Linux init / hotplug |
| WireGuard VPN Support | Basic VPN Fusion Client | In-Kernel Server & Client | Native In-Kernel (Fastest) |
| Guest Network Isolation | Basic Client Isolation | YazFi (Multi-Subnet VLAN) | Full 802.1Q Subnets |
| Package Management | None | Entware (2,500+ pkgs via amtm) | opkg (10,000+ packages) |
| Revert to Factory Firmware | N/A | 100% Safe (Flash stock .trx) | Requires TFTP / OEM bin |
Asuswrt-Merlin Installation & Hardening Checklist
- Verify your router model is supported on the official Asuswrt-Merlin download portal (e.g., RT-AX86U Pro or GT-AX6000).
- Download the correct zip archive for your exact model and verify the SHA-256 checksum against the official release notes.
- Extract the firmware file (
.wor.trx) and upload it through the stock web interface under Administration > Firmware Upgrade. - Wait 3 to 5 minutes for the flash sequence to complete and the router to reboot (never unplug power during flashing).
- Enable JFFS custom scripts and configs under Administration > System, then format the JFFS partition on next reboot if performing a major version upgrade.
- Plug in an ext4-formatted USB drive, SSH into the router, and launch
amtmto configure swap space, YazFi, and Diversion.
Frequently Asked Questions
Can I flash back to stock ASUS firmware if I don't like Merlin?
Yes, 100% safely. Asuswrt-Merlin uses the exact same firmware header structure as official ASUS firmware. You can revert at any time simply by downloading the latest stock firmware from ASUS's official support website and uploading it through the normal Web GUI Firmware Upgrade page.
Does Asuswrt-Merlin support ASUS AiMesh?
Yes. Asuswrt-Merlin fully supports AiMesh. A router running Merlin can serve as the primary AiMesh router with stock ASUS routers connected as wireless or wired nodes. However, Merlin features and custom JFFS scripts run exclusively on the primary router, not on child mesh nodes.
Do I need to do a factory reset after flashing Asuswrt-Merlin?
If you are upgrading from stock ASUSWRT on the same base codebase, a factory reset is usually not required; all your existing Wi-Fi names, passwords, and port forwardings will be preserved. However, if migrating across major code branches (such as 386.x to 388.x) or encountering strange web UI bugs, a hard factory reset is recommended.
Why is Asuswrt-Merlin not available for Netgear or TP-Link routers?
Asuswrt-Merlin is fundamentally tied to ASUS's proprietary ASUSWRT operating system and Broadcom SDK. It cannot run on hardware from other manufacturers like Netgear, TP-Link, or Linksys. For non-ASUS routers, OpenWrt, DD-WRT, or FreshTomato are the appropriate open-source alternatives.
Related Firmware & Driver Directory & Engineering Guides
- WireGuard Router Setup Guide (Client & Server) — Set up WireGuard VPN on ASUS, GL.iNet, UniFi, and MikroTik routers. Configure Curve25519 keys, AllowedIPs, MTU 1420 tuning, and NAT keepalive timers.
- How to Fix Bufferbloat: SQM (Cake & FQ_CoDel) Router Guide — Eliminate gaming lag spikes and Zoom freezes by testing for bufferbloat and configuring SQM (Cake or FQ_CoDel QoS) at 85% to 92% of your ISP line speed.
- Default Router IP Address & Login Passwords List (Top 16 Brands) — Find the default IP address, username, and password for any router. Complete master table for Netgear, ASUS, TP-Link, Linksys, Ubiquiti, Arris, and Motorola.
- Router & Switch Firmware Update Checklist — Follow our pre-flight router and switch firmware update checklist. Plan maintenance windows, archive rollback images, verify CVE fixes, and test VLANs.