Upgrading your LibraryBox should be a fast and painless exercise. Follow the steps below to upgrade your existing LibraryBox to the v2.1 release. Be warned: upgrading an existing LibraryBox will reset any customizations you may have done to your existing install. Please back up your Shared directory, Content directory, and any other customizations before upgrading.

  1. Power off the router
  2. Unplug the USB Drive from the router, and plug it into your computer
  3. Download the firmware for your device:
  4. Copy the file onto your USB Drive
  5. Safely eject the USB drive from your computer, place it back into the router, and power up the router.
  6. Connect the router via ethernet cable to your computer and power up the router. Once the router is running, open a terminal window (for OS X, go to Applications > Utilities > Terminal; for Windows, install and open PuTTY) and log in with ssh:
    ssh root@ 
    Note: If you haven't set up a password yet, use the telnet command instead of ssh:
  7. Navigate to the /mnt/usb directory:
    cd /mnt/usb
  8. Install the LibraryBox v2.1 firmware with:
    sysupgrade -n YOUR_FIRMWARE_NAME_HERE
    Note: Use your “tab” key at the end of “openwrt” to autocomplete the full file name of the firmware. Note: If sysupgrade refuses the upgrade and you are sure it is the correct file, then you can trigger the flash with the following command
    mtd write -r YOUR_FIRMWARE_NAME_HERE firmware
  9. After the upgrade completes, the router will restart twice. Just be patient and let it blink for 10-15 minutes.
  10. Once the lights on the routers are in a steady state, turn off the router and remove the USB flash drive and insert it into your computer.
  11. Download the LibraryBox v2.1 Install folder (as zip file) MD5 Hash: 85BF5A80220B9C8204303C6099908A7D
  12. Extract the install_librarybox.zip file and drag the “install” folder over to your USB flash drive.
  13. Navigate to the USB drive and into the LibraryBox folder. Rename the Content and Config folders to Content_old and Config_old respectively. The v2.1 upgrade will generate new Content and Config directories...if you have customized anything in these folders, you will need to re-copy those customizations into the newly created folders.
  14. Now SAFELY REMOVE your USB drive from your computer and plug the USB stick into your router.
  15. Power the router on. That will trigger the installation of the new packages. Note: You should wait 15-20 minutes for the installation to complete (depending upon your USB flash drive, it may take up to 45 minutes - be patient!). Your device will reboot a couple of times during the installation.
  16. Once the installation is complete, you can use telnet to connect to the device:
  17. We recommend going over to the Building page, and following the instructions to set a password for your LibraryBox.

Website Content - Creative Commons Licensed NC-BY Jason Griffey 2012, where not otherwise licensed.
Software Licensed under GPLv2, see http://www.gnu.org/licenses/gpl-2.0.html Back to Top