XrayUIXrayUI
  • How to install
  • Interface Overview
  • Importing the Configuration
  • Bypass/Redirect Policy
  • Subscription Management
  • DNS Leak
CLI
Changelog
  • English
  • Russian
  • How to install
  • Interface Overview
  • Importing the Configuration
  • Bypass/Redirect Policy
  • Subscription Management
  • DNS Leak
CLI
Changelog
  • English
  • Russian
  • Guides

    • How to install
    • Interface Overview
    • Importing the Configuration
    • Bypass/Redirect Policy
    • Subscription Management
    • DNS Leak
  • CLI
  • Changelog

Install

Get XrayUI running on your Asuswrt‑Merlin router in a few minutes.

Requirements

  • Asuswrt‑Merlin 384.15+ or 3006.102.1+.
  • SSH access enabled on the router.
  • A USB flash drive for Entware storage.
  • Entware installed via amtm.
  • JFFS custom scripts enabled (set it in the MerlinWRT settings).

Prepare the router

Enable JFFS custom scripts

On the router web UI: Administration → System → Enable JFFS custom scripts and configs → Yes (if not set). Reboot the router.

Install Entware with amtm

Open an SSH session to the router and run:

amtm

Choose Entware from the menu and follow the prompts.

Install XrayUI

Run this command in SSH to fetch and install the latest release:

wget -O /tmp/asuswrt-merlin-xrayui.tar.gz https://github.com/DanielLavrushin/asuswrt-merlin-xrayui/releases/latest/download/asuswrt-merlin-xrayui.tar.gz && rm -rf /jffs/addons/xrayui && tar -xzf /tmp/asuswrt-merlin-xrayui.tar.gz -C /jffs/addons && mv /jffs/addons/xrayui/xrayui /jffs/scripts/xrayui && chmod 0777 /jffs/scripts/xrayui && sh /jffs/scripts/xrayui install

After installation

  • Log out of the router UI and log back in.
  • Navigate VPN → X‑RAY in the web interface.

Update

There are 2 ways to perform the update:

  1. run the command

    xrayui update
    
  2. From the Web Interface in the bottom right corner click the yellow version link and the Update window will pop-up. Now you can perform the update from the UI.

Uninstall

Simply run this command:

/jffs/scripts/xrayui uninstall
Last Updated: 7/28/25, 8:16 PM
Contributors: Daniel Lavrushin
Next
Interface Overview