Asuswrt-Merlin Firmware: Complete Install, Features & Scripting Guide

Updated 2026-11-18 • By Marcus Vance, CCNA (Senior Network Engineer & Editorial Lead)

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.

Key Technical Takeaways
  • 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 custom iptables/nftables rules or override dnsmasq.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 .w or .trx update 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.
Architecture diagram showing Asuswrt-Merlin core enhancements, JFFS scripting, and Entware add-on ecosystem
Figure 1: Asuswrt-Merlin three-layer architecture: official Broadcom kernel acceleration, Merlin core enhancements, and Entware community add-ons.

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:

  1. 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.
  2. Diversion: A full-featured router-level ad-blocker using dnsmasq and custom blocklists, eliminating tracking beacons and mobile ads across every device on your network without installing client apps.
  3. 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 / MetricStock ASUSWRTAsuswrt-MerlinOpenWrt
Base Operating SystemProprietary ASUS LinuxEnhanced ASUS GPL ForkModular FOSS Linux (musl)
Hardware NAT (CTF / Runner)Active (100% Line Rate)Active (100% Line Rate)Software Flow Offloading
Broadcom Wi-Fi DriversOfficial Proprietary BlobsOfficial Proprietary BlobsReverse-Engineered (Limited)
Trend Micro AiProtectionIncluded (Free Lifetime)Included (Free Lifetime)Not Supported
SSH & Terminal AccessBasic Dropbear ShellFull OpenSSH (Key Auth)Full OpenSSH / Dropbear
JFFS Lifecycle ScriptingDisabled / UnsupportedFully Supported (Bash)Full Linux init / hotplug
WireGuard VPN SupportBasic VPN Fusion ClientIn-Kernel Server & ClientNative In-Kernel (Fastest)
Guest Network IsolationBasic Client IsolationYazFi (Multi-Subnet VLAN)Full 802.1Q Subnets
Package ManagementNoneEntware (2,500+ pkgs via amtm)opkg (10,000+ packages)
Revert to Factory FirmwareN/A100% Safe (Flash stock .trx)Requires TFTP / OEM bin

Asuswrt-Merlin Installation & Hardening Checklist

  1. Verify your router model is supported on the official Asuswrt-Merlin download portal (e.g., RT-AX86U Pro or GT-AX6000).
  2. Download the correct zip archive for your exact model and verify the SHA-256 checksum against the official release notes.
  3. Extract the firmware file (.w or .trx) and upload it through the stock web interface under Administration > Firmware Upgrade.
  4. Wait 3 to 5 minutes for the flash sequence to complete and the router to reboot (never unplug power during flashing).
  5. Enable JFFS custom scripts and configs under Administration > System, then format the JFFS partition on next reboot if performing a major version upgrade.
  6. Plug in an ext4-formatted USB drive, SSH into the router, and launch amtm to 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

Reviewed by Marcus Vance, CCNA (Senior Network Engineer & Editorial Lead)

Part of the Packetsaver Network Engineering Team. All configurations and firmware safety instructions follow vendor-verified RFC and IEEE standards. Read our testing methodology →