Installing Entware

From DD-WRT Wiki

(Redirected from Installing Entware-3X)
Jump to: navigation, search


[edit] Introduction

What is Entware? It is a software repository for embedded devices like routers or network attached storages. >1800 packages are available. It was founded as an alternative to very outdated Optware packages. Within five years of development several Entware forks were born to run on NASes, PCs and new ARM routers. Now x86, x64, MIPS, MIPSEL, ARMv5 and ARMv7 forks are merged into Entware. It's maintained by the same team as Entware before. See more here: Entware on Github

A list of Entware packages is here, this list is for ARMv7, but it is most likely similar for all architectures.

Feel free to ask for new packages here, if your request will be supported by one or more users, it will be added to the repo. Be ready to provide feedback about the package you requested.

[edit] Preparation

  1. Log in to the router's GUI, go to the USB page (Services - USB), Make sure Core USB Support, USB Storage and Automatic Drive Mount are all enabled. If one or more are not, enable them and click apply.
  2. On your computer plug in the USB stick or harddrive, reformat the USB stick or harddrive using a program like Partition Wizard (Windows) or GParted (Linux). Make sure the format of the drive is ext2 for a USB stick, or ext3 or NTFS if it is a harddrive, Primary, not Logical. Label should be Optware if you want it to mount automatically.
    • Center Click image to enlarge.
  3. (Optional) Install an ext driver on Windows (, helpful for troubleshooting.
  4. Determine the architecture of the router you are using.
    • Check the Router Status page in the webUI
    • via telnet or ssh issue the command 'uname -a'
  5. Make a note of this for later. If you can't determine the architecture to use, ask in the forums.
    Note: if the router is using a Linux 4.X kernel, Entware-3X may not work.

[edit] Installation

  1. Plug in the USB stick or harddrive into the router. The router 'may' have to be rebooted. Check Services – USB to see if it shows up. Make a note of the current mount point, ex: /tmp/mnt/sda_part1, should be /opt if you did the above correctly.
  2. Open up a putty (SSH) terminal to the router. Type in the following commands using the mount point above:
cd /opt (click enter)
wget {link to std install script for your router} (click enter)
sh (click enter)

For MIPS based devices (Atheros, not dual core), this will be:

cd /opt (click enter)
wget (click enter)
sh (click enter)

For MIPSEL based devices (Broadcom, not dual core), this:

cd /opt (click enter)
wget (click enter)
sh (click enter)

For dual-core routers, ARMv7 based, this:

cd /opt (click enter)
wget (click enter)
sh (click enter)

  • NOTE: if you get nslookup: can't resolve '' then most likely your /etc/resolv.conf file has only a local nameserver entry (nameserver
edit your /etc/resolv.conf file insert nameserver save the file, and repeat your wget

  • The third command from above sh runs the install script which downloaded several files from the internet and set up Entware. It will most likely show several packages that have no valid architecture, just ignore them. These will show up when any opkg command is run.

When installation is complete, run an update:

opkg update (click enter)
opkg upgrade (click enter)

The Final Step is to add the following commands to the start-up script (Administration tab - then Commands). The sleep value can be adjusted, but 10 is long enough for most USB Harddrives/routers:

sleep 10
/opt/etc/init.d/rc.unslung start

Note: Don’t add anything to the PATH or LD_LIBRARY_PATH variables, they already include the /opt locations of the necessary folders.

Note: Be aware that routers have limited RAM and some have a weak CPU, do not expect a $10 or $20 device to be able to handle torrenting (Transmission) for example.

Installation Completed

You are now ready to install any Entware packages you want. See this link for the Package List for MIPSEL, most likely the same for all architectures.

Note: you can also run opkg list from your router's command line, to see a list of packages.

[edit] Package Installation

Before Installing packages run an update, then do the install:

opkg update (click enter)
opkg install (name of package) (click enter)

Note: Package upgrades can fail when dependencies are changed. The Entware Wiki note says to uninstall and reinstall the package Note about pkg upgrades

[edit] Entware Wiki

Please also see the Entware Wiki page for more information

[edit] Upgrading DD-WRT

Before upgrading DD-WRT, it is best to remove the Entware drive, or at least disable USB support. Upgrading DD-WRT should not cause any problem to your Entware installation, so long as the devs do not change the PATH or LD_LIBRARY_PATH variables mentioned above. After upgrading, just plug the drive back in or enable USB support again. Then open a SSH terminal and issue the following commands:

opkg update (click enter)
opkg upgrade (click enter)