Tomato Firmware
Readme

Tomato is a small, lean, simple replacement firmware for Linksys' WRT54G/GL/GS, Buffalo WHR-G54S/WHR-HP-G54, and other Broadcom-based routers. It features a new easy to use GUI, a new bandwidth usage monitor, more advanced QOS and access restrictions, enables new wireless features such as WDS and wireless client modes, raises the limits on maximum connections for P2P, allows you to run your custom scripts or telnet/ssh in and do all sorts of things like re-program the SES/AOSS button, adds wireless site survey to see your wifi neighbors, and more.

Please consider donating if you like it. :)


Want to learn more about Tomato?

Homepage: http://www.polarcloud.com/tomato/
FAQ: http://www.polarcloud.com/tomatofaq
Wikibook (en): http://en.wikibooks.org/wiki/Tomato_Firmware
Wikibook (de): http://de.wikibooks.org/wiki/Tomato_(Firmware)

• The GUI username is "admin" or "root" (username is required), ssh and telnet username is always "root", and the default password is "admin".
• By default, the SES (aka AOSS, EZ-Setup) button is programmed to start a password-less telnet deamon at port 233 if held for 20+ seconds. If you run into a problem of not being able to login, you can use this to view or reset the password ("nvram get http_passwd" and "nvram set http_passwd=newpassword"). You can disable this behavior in Admin/Buttons.
• If you're upgrading from DD-WRT v23 SP2+, be aware that you may get locked-out because of a change in DD-WRT's use of the nvram password variable. You have a few options: (1) Push the reset button to reset all the configuration after installing Tomato. (2) Use the SES button as described above. (3) Type "nvram get http_passwd" while running DD-WRT and write down the result - this will be your password after loading Tomato.
• The firmware files:
  • WRT54G_WRT54GL.bin is for Linksys WRT54G v1-4 and WRT54GL.
  • WRT54GS.bin is for Linksys WRT54GS v1-3.
  • WRT54GSv4.bin is for Linksys WRT54GS v4.
  • WRTSL54GS.bin is for Linksys WRTSL54GS (No USB support).
  • WR850.bin is for the Motorola WR850G/GP (See warning below before installing).
  • tomato.trx is for the Buffalo WHR-G54S, WHR-HP-G54, WZR-G54, WBR2-G54, Asus WL-500G Premium (No USB support), and others.
  • tomato-ND.trx is for the WHR-G125, WL520GU, and others.

• Open Tomato's GUI in your browser.
• Click Administration, then Upgrade.
• Select any of the firmware files.
• Click the Upgrade button.
• Wait for about 2 minutes while the firmware is uploaded & flashed.

Tomato's firmware files are standard formats and in most cases can be used to install directly from other firmwares. The only thing you need to do is open the router's current UI in your browser, and using the same method you use to upgrade the firmware, pick a Tomato firmware file appropriate for your router and "upgrade".

Note: Some settings may not be compatible with Tomato. Resetting the router settings (Administration->Configuration) after installing Tomato is recommended.

• Open the Linksys GUI in your browser. The default URL is http://192.168.1.1/.
• Click the Administration tab, then Firmware Upgrade.
• Select and upload the correct firmware for your router.
• Wait for about 2 minutes while the firmware is uploaded & flashed.

WARNING: Be aware that you may not be able to re-install the original firmware back if Buffalo only has the encrypted version of the firmware available for your router.

• Push and hold the reset button on the router for a few seconds to reset the configuration.
• Plug your computer directly to the router. This will not work over a wireless connection.
• Set your computer's ethernet card settings to: IP=192.168.11.2, mask=255.255.255.0, gateway=192.168.11.1.

  In Windows, you can set this by going to Control Panel, Network Connections, right-click your ethernet card, click Properties, then select "Internet Protocol (TCP/IP)", then click Properties, click "Use the following IP address". You can leave the DNS settings blank.

• Make sure the red diagnostic light isn't lit on the router, unplug the power cable to the router.
• Double-click on the whr_install.bat file.
• Re-plug the power cable to the router.
• There's only about a 5-second window between when the router looks for a new firmware and when it gives up and loads the current firmware. If it doesn't work, unplug, the router, wait a few seconds and try again.
• After uploading, wait. It still needs about 2 minutes to flash the image.
• Reset your computer's ethernet card settings back to use DHCP.

  In Windows, you can set this by going to Control Panel, Network Connections, right-click your ethernet card, click Properties, then select "Internet Protocol (TCP/IP)", then click Properties, click "Obtain IP address automatically" and "Obtain DNS server address automatically".

• The default router address after installing Tomato is 192.168.1.1. TFTP-based upgrades will also use this address and will follow the whatever setting you enter in the GUI.
• Make sure you're entering the username "root" and password "admin". Unlike the default firmware, they are required in Tomato.
• A complete reset of the router after installing Tomato for the first time is recommended. Go to Administration/Configuration then under Restore Default Configuration, select "Erase all Data in NVRAM (thorough)", then click OK. When the router restarts then you can go into the Configuration and makes any changes that you need to.

WARNING: Some of these routers will not setup the nvram on their own. To make sure the nvram config is built properly, load the original Motorola firmware v6.1.4 (or above) first and select "Restore Factory Configuration" before installing Tomato.

• Open Motorola's GUI in your browser. The default URL is http://192.168.1.1/.
• Go to Administration/Upgrade.
• Select Tomato's WR850 file.

Rename tomato-ND.trx to WL520gu_2.0.0.9_EN.trx and upgrade as usual.

If the above doesn't work, use the tftp method:

• Manually set your computer's IP address to 192.168.1.2 and gateway to 192.168.1.1. [expand]
• Turn off the router, then hold the reset button while turning it back on.
• Release the reset button when the power led flashes.
• Run "tftp -i 192.168.1.1 put tomato-ND.trx" from a console/command line (quickly). It may help if you pre-type the command and press ENTER when ready.
• After uploading, wait - do not touch the router. It may take around 2 minutes to flash the image and reboot the router.

• Open the GUI in your browser. The default URL is http://192.168.1.1/.
• Click Administration, then Upgrade.
• Important: Make sure the firmware you are going to use is the correct kind for your router's model. Tomato will accept WRT54G/GL, WRT54GS, WRT54GSv4, WRTSL54GS, WR850G and TRX types of files, but it cannot check if the firmware actually supports your router.
• Select the file and click the Upgrade button.
• Wait for about 2 minutes while the firmware is uploaded & flashed.
• You may need to push the router's reset button to reset its configuration, and release/renew your computer's DHCP lease afterwards.

• There is no help file.
• In some cases, you may need to reboot the router manually before the changes go into effect. If the changes involve switching wireless settings, you may need to reboot both ends.
• Not all wireless modes / security combinations work. For example, WET, Client and WDS will not work in WPA2.
• CIFS VFS timesout a lot. (or it might the server kicking the client off...)
• Graphs/SVG may not work with all browsers. Firefox: Use 1.5 or higher. Internet Explorer: Use Adobe SVG. Opera: Use 9.0 or higher. Safari: Use Safari 3 or newer.
• GUI settings are not saved by Opera if using IP address. The only work-around is to use the router's hostname (http://hostname/) instead of an IP address (http://192.168.0.1/). You can modify the hostname in Basic/Identification, or you can also edit your computer's /etc/hosts or C:\windows\system32\drivers\etc\hosts if you're not using the router's DNS forwarder.

Version 1.27

• Fix DDNS "-1" error when service used HTTPS.

Version 1.26

• Allow a different port to be entered in Basic:Network:Static DNS (enter as "ip:port"). Be aware that dnsmasq must act as the DNS server (the default setting) when not using the normal port 53.
• Allow DHCP to serve the user-entered gateway (in Basic:Network) if the option in Advanced:DHCP is enabled.
• Do not start miniupnpd early to avoid warning messages.
• Update Australian DST (need to re-select), add Darwin, Brisbane TZ. Thanks to Peter O. for the info.
• Avoid double loading of tomato.css
• Fix possible null dereference in sendpage
• Collapsed all menus. For the old look, set nvram: "web_mx=status,bwm,tools"
• Obscured some key/password fields when not in focus.
• Accept more than two MAC addresses per IP address (ex: one IP for a laptop either wired or wireless [one at a time]). Note: Some computers may not like seeing the same IP unless it's restarted.
• Added LED options back in Admin:Buttons/LED.
• Added ID for WLA2-G54L, TrueMobile 2300 thanks to Nick B. and David J.
• Added EditDNS thanks to Keith M.
• Added UTC+4:30 Kabul time zone.
• Fixed port set validation allowed more than what could be handled.
• Allow rstats to log if WAN port is used for LAN.
• Update dnsmasq to 2.51, miniupnpd 1.4, busybox 1.14.4, matrixssl 1.8.8.

Older »

In Windows

• Go to the Control Panel, then click Network Connections.
• Right-click on your ethernet card, click Properties, then select "Internet Protocol (TCP/IP)".
• Click Properties, click "Use the following IP address".
• Enter the IP address and gateway.