How to install Entware



Entware is a modern alternative to Optware. Originally designed for OpenWRT, it is also usable by other firmware platforms such as Asuswrt-Merlin based routers
This version is for mipsel devices: RT-N16, RT-N66U/R, RT-AC66U/R

Arm version here

Installing Entware on asuswrt routers is very easy, starting with firmware v3. a new script has been created by our beloved ryzhov_al to facilitate Entware installation.

0 - Remove Asus Download Master if is installed

1 - Download custom firmware from here, go to firmware upgrade page and upload normaly like a stock one

2 - Plug in a usb-flash formatted EXT2 or a usb-hdd formated EXT3 on usb port

3 - Go to Advanced_System_Content, check "Enable JFFS Partition", "Enable JFFS custom scripts and configs" and "Enable SSH", press Apply and Reboot



4 - After reboot, connect to router with putty terminal and type
Info: This script will guide you through the Entware installation.
Info: Script modifies only "entware" folder on the chosen drive,
Info: no other data will be touched. Existing installation will be
Info: replaced with this one. Also some start scripts will be installed,
Info: the old ones will be saved to .entwarejffs_scripts_backup.tgzInfo: Looking for available partitions...
[1] --> /tmp/mnt/sda1
=> Please enter partition number or 0 to exit

5 - Choose a partition where Entware should be installed, in this case is only [1] --> /tmp/mnt/sda1



Info: /tmp/mnt/sda1 selected.

Info: Creating /tmp/mnt/sda1/entware folder...
* Warning: Deleting old /tmp/opt symlink...
Info: Creating /tmp/opt symlink...
Info: Creating /jffs scripts backup...
tar: removing leading '/' from member names
Info: Modifying start scripts...
Info: Starting Entware deployment....

Connecting to (
- 100% |*******************************| 1141 0:00:00 ETA
Info: Checking for prerequisites and creating folders...
Info: Opkg package manager deployment...
Connecting to (
opkg 100% |*******************************| 456k 0:00:00 ETA
Connecting to (
opkg.conf 100% |*******************************| 105 0:00:00 ETA
Info: Basic packages installation...
Updated list of available packages in /opt/var/opkg-lists/openwrt.
Installing uclibc-opt (0.9.32-4) to root...
Installing libc (0.9.32-6) to root...
Installing libgcc (4.6.4-6) to root...
Installing libstdcpp (4.6.4-6) to root...
Installing libpthread (0.9.32-6) to root...
Installing librt (0.9.32-6) to root...
Installing ldconfig (0.9.32-6) to root...
Installing findutils (4.5.12-1) to root...
Configuring ldconfig.
Configuring libgcc.
Configuring libc.
Configuring libpthread.
Configuring libstdcpp.
Configuring librt.
Configuring findutils.
Configuring uclibc-opt.
Updating /opt/etc/ done.
Info: Cleanup...
Info: Congratulations!
Info: If there are no errors above then Entware successfully initialized.
Info: Found a Bug? Please report at

If you get some errors, reboot router and continue from step 4

6 - The script will create a directory named "entware" in the selected partition, type cd /opt

cd /opt
admin@RT-AC66U:/tmp/mnt/sda1/asusware# cd /opt

7 - Now Entware is installed on your asuswrt router, it's time to install some packages, ex. nano text editor:

opkg install nano
admin@RT-AC66U:/tmp/mnt/sda1/entware# opkg install nano
Installing nano (2.2.6-1b) to root...
Configuring nano.


8 - Create SWAP FILE (Highly recommended)

Sometimes router goes out of memory and this can be fixed by creating a swap partition but it's a little bit to complicated for most users and we will create a swap file instead, 512MB is more than enough:

cd /opt
dd if=/dev/zero of=swap bs=1024 count=524288
mkswap swap
chmod 0600 swap
swapon swap

To enable swap file when router booting, create /jffs/scripts/post-mount script with

nano /jffs/scripts/post-mount

Paste this lines in terminal


swapon /opt/swap

Save with CTRL-O / Enter / and exit with CTRL-X
To unmount swap create /jffs/scripts/services-stop script with
nano /jffs/scripts/services-stop

Paste this lines in terminal


swapoff /opt/swap

Save with CTRL-O / Enter / and exit with CTRL-X
Make scripts executable
chmod a+rx /jffs/scripts/*

If you have difficulties, try installing with the old method.

9 - If your services don't start automatically after reboot, add /opt/etc/init.d/rc.unslung restart to /jffs/scripts/post-mount script

echo -e "">>/jffs/scripts/post-mount
echo -e "sleep 30">>/jffs/scripts/post-mount
echo -e "/opt/etc/init.d/rc.unslung restart">>/jffs/scripts/post-mount
  • Robin Åström

    Hi, new problem.
    Install of entware + nano text editor + transmission goes great, starts up and works fine, until i reboot my router, then entware stops working.
    I've added:
    echo -e "">>/jffs/scripts/post-mount
    echo -e "sleep 30">>/jffs/scripts/post-mount
    echo -e "/opt/etc/init.d/rc.unslung restart">>/jffs/scripts/post-mount
    to jffs script, but still doesn't work.
    Have formatted the external hdd and re-installed everything 3-4 times today, thinking that I did something wrong.
    I´m unable to solve this, have googled on it, but just found old forum threads from 2012-13, saying I should downgrade my firmware once then upgrade to an older version then upgrade to the latest version, but I don't trust that since it's so old.
    So frustrated right now that i could smash my keyboard in a million bits. Please help!!

    • I have to modify script a little bit but until I will have some free time, why don't you try installing Optware New Generation instead?

      • Robin Åström

        Thx! I'll try that!

  • Dgo

    I couldnt really wait so i tried entware from optware- worked for a moment but started running into the same problem. I was able to update everything but all of the sudden it stopped working. I have two routers ( Verizon) and then I have a cisco router and behind that I have the RT-AC66U giving wireless support. I wanted to say that to say this; From the Asus AC66U - i can pass one hop which is the cisco but ends on the gateway router ( Verizon). After updating nameservers to cisco and verizon routers it worked after a while then stopped working. So, what i really need to know is what of the resolv.config files ( since they are so many) do i need to update to get DNS to resolve to the repository and be able to udpate accordingly.

    Is there a tutorial to install opkg packages manually?

  • Fanatico_PTY

    My SWAP file is not working, not sure what i'm doing wrong.

    • What do you mean not working, is not mounted or is always zero?

      • Fanatico_PTY

        Is not mounted and is always zeros

  • Zukk

    how do you format an usb to ext2?

  • duong trung

    Hi, Thank you very much for your instruction. I like it very much!

    I have a problem. I installed entware and transmission on Usb flash 4gb. I followed intructions until the step "create swap file" but when I tried to do the command I found nothing happened. It looked like I was typing a document. The command line wasn't active. I posted command line followed . could you help me please ?

    • Reboot router and try again

      • duong trung

        I tried again a let waited for a while. After a minute or more , the command was active. Thanks again for you tutorials!

  • BlockHeid

    Sorry to sound dumb however can someone advise exactly what entware is / does and why the need for a memory stick?

    My router RT-N66U (bought yesterday) has latest asuswrt-merlin installed and is currently a "virgin", any heads up to what can be done to it now would also be appreciated :-)

    • You need an usb drive for entware files.

      Entware is a modern alternative to Optware. Originally designed for OpenWRT, it is also usable by other firmware platforms such as DD-WRT or Tomato. You can also set this up on your Asuswrt-Merlin based router.

      On entware you can install some "programs" that are not included in router firmware. Here is the last with available packages

      • BlockHeid

        Thanks for the information much appreciated!

        Shall have a wee tinker about with it!

  • DerpHammer

    Thanks! Asus broke the minidlna server by using a non-threadsafe sqlite. I'm using your tutorials to install the debian version.

    • You are very welcome, please share feedback

      • DerpHammer

        It's working great. :) I also enabled the thumbnailing option for my Samsung TV, which is fantastic. The debian squeeze version gives me a lot more control over the minidlna config, so I'm sold. Inotify was the main reason I switched over and that is working like it's supposed to now. NZBDrone combined with minidlna/iNotify is making me really happy.

Get Email Notification When a Server or Port is Unreachable
SoftEther VPN Running on AsusWRT Routers
Minidlna UPnP Media Server through Debian Jessie Arm
How to Mount Samba Shares inside Chrooted Debian
Minidlna UPnP Media Server through Debian Jessie Arm
How to Mount Samba Shares inside Chrooted Debian
Spreed WebRTC server and web client
Asterisk VoIP Server running on AsusWRT Routers
Get Email Notification When a Server or Port is Unreachable
SoftEther VPN Running on AsusWRT Routers
NZBGet through Entware
Minidlna UPnP Media Server through Debian Jessie Arm


To be notified by email when a new tutorial is posted :)

Thanks for Subscribing! I'll keeping you up-to-date with latest tutorials!

Something went wrong, try again...