Howto install the OpenWRT-Firmware on a Linksys WRT54g


OpenWRT is a highly configurable firmware for the WRT54G. It provides different packages for diverse functionalities. This howto will cover the basic installation of the firmware, as well as some specific configurations.

Other Sources

There are several howtos for OpenWRT on the net:

  1. OpenWRT userguide
  2. Howto on, vienna wireless

Basic Install

The basic installation is documented on the OpenWRT homepage, in the userguide section. In most cases you can skip the part about compiling from source.

  1. Grab a snapshot of a pre-compiled firmware
  2. Follow the instructions from here

Connect to the Linksys via telnet

OpenWRT by default installs telnet on the Linksys. To access it you need a telnet client, which is installed on most Operating Systems by default. Connect your computer to one of the LAN-Ports on the back of the Linksys. To open a telnet-connection:

  • on Windows: -->Startmenu-->Ausführen--> telnet
  • on MacOSX: ??
  • on Linux: telnet

There is no login/pass on telnet. You can now start to configure the linksys to your demands. To close the connection do "CTRL-D"


Before you can install new software on the linksys, you will need to connect it to the internet. For this howto we will assume that you have access to the internet via a LAN. Connect the WAN-interface of the Linksys with a cable to the network. To configure the WAN-interface of the router, issue the following commands:

  nvram get wan_ifname  (this will print the name of the WAN interface)
  ifconfig <name-of-WAN-interface> (put in an ip used on the LAN)
  route add default gw (put in the ip of the gateway)
  echo >> /etc/resolv.conf  (this configures the nameservers)
  ping (to test if it works, abort with CTRL-C)

Install ssh (dropbear)

Telnet is by design very insecure, a far better way of configuring the router is ssh. there is a ssh-server for OpenWRT available, its name is dropbear. you can use the "ipkg" tool to install it. login to the linksys using telnet and issue the following commands:

 ipkg update
 ipkg install dropbear

The first command will get a currenty list of available software from the internet and the second command installs the dropbear-ssh-server.

Now you need to set the root-password:


After restarting the router you can login via ssh.

  • on linux: ssh
  • MacOSX: open a console, and type ssh
  • On Windows you will need a seperate ssh-client, putty is a good one. Type into the address field, select ssh as protocol and press connect.

Login with username: root and pass: whatever you chose as root-password. If this works, you can now safely stop the insecure telnet service:

  rm /etc/init.d/S41Telnet

Configuring the network

Ad-hoc networking

Accesspoint (AP)


Further Resources

.. to be continued