User Tools

Site Tools


docs:guide-quick-start:factory_installation

Factory install: First-time installation on a device

Your device must still have the vendor firmware to be eligible for this so-called “factory installation” procedure.

Device selection

  • Devices with >=8 MBytes Flash memory and >=64 MBytes RAM allow a full-featured LEDE installation with GUI.
  • Devices with 4 MByte or less Flash memory can install LEDE as well, but with a limited feature set. They cannot use optional packages and in some cases may also not have a web GUI, due to limited flash space and may therefore have to stick to command line administration only. The creation of individual custom packages may help to avoid some of these limitations on such 'small' devices, but such a custom-package-creation is not part of this howto.
  • If you want to purchase a new router for LEDE, stick to devices with >=8 MBytes Flash memory and >=64 MBytes RAM.

Locate and download the LEDE firmware

  1. On the Table of Hardware: Firmware downloads page, locate your specific device. The table of hardware only references stable release versions of LEDE. If you are a newcomer, use the stable release version for your first-time device installations. Do not initially use a (clearly marked) develop/snapshot version from other subfolders. This ensures that you get the easiest possible first-time LEDE installation experience.
  2. When you have located your device in this list, click on the “View/edit data” link of the device record. This will open a new page with several details for your specific device. We recommend to bookmark that page, as it has lots of helpful information about your router.
  3. On this device-specific Techdata page, at the bottom locate the line called “Firmware LEDE Install URL that links to a downloadable file called ”…factory.bin” or “…factory.img” file.
  4. Download this file.

Troubleshooting:

  • If you can only find a LEDE “sysupgrade.bin” file, but no “factory.bin” firmware file, a device-specific custom installation procedure is required (Assuming your device does not already have an older LEDE or OpenWrt version installed). You can find custom installation instructions at the following locations:
    1. On the LEDE Techdata page of the device, check the fields “LEDE Forum Topic URL” and “Comment” for any external links or comments regarding custom installation procedures.
    2. Look for the corresponding device page in the older OpenWrt wiki, if that has any custom installation descriptions (Eventually older OpenWrt info will be migrated to the LEDE tech data pages).
    3. Search the LEDE forum for existing discussion threads about the device name or open a new topic in the LEDE forum, asking for instructions.
  • If you can't find your device in the Table of Hardware, you can consult the "Installing and Using LEDE" Forum for help. You can also try alternative ways to locate LEDE firmware images.
  • If you have accidentally browsed the generic LEDE download folders to locate your device, you might see some more download files matching your device. Ignore those other files for your device: you only want the “…factory.bin” of “…factory.img'' file.

Verify the downloaded firmware file

You will now use a checksum tool, to calculate a checksum from your downloaded file and then compare this calculated checksum with the file-specific checksum listed on the firmware download site. This ensures that you have a 100% correct download and that you will not brick your device by applying a faulty download.

  1. Check your downloaded ”…factory.bin“ file according to checksum verification of downloaded LEDE firmware files.
  2. Only continue with flashing, if the firmware checksum of your download matches the checksum stated on the download site!

Troubleshooting:

  • if the checksum process has reported a checksum mismatch, do NOT start flashing, as the download could be corrupt. A corrupt firmware file can brick your device! Instead retry with another download attempt and retry the checksum step.
  • if the checksum step fails repeatedly, you can consult the "Installing and Using LEDE" Forum for help. Be sure to include the exact brand, model, and version of your device.

Flash the firmware

  1. Connect to the device via Ethernet cable (Only fallback to wireless, if the device has no Ethernet connection options)
  2. Ensure that the LEDE firmware file that you are about to flash, matches your router model and is called ”….factory.bin“, as you will use it to modify a vendor's factory firmware towards LEDE.
  3. Log into the device's admin web interface and locate the device-specific firmware installation function. Follow the device-specific instructions of your manufacturer's user guide for installing firmware and use this to install the ”…factory.bin“ firmware file of LEDE.
  4. Wait while the device writes the firmware image to its flash memory. This can take several minutes (the Device Page may state an expected time for this process). At the end, the device will reboot automatically.
  5. The new firmware has been installed.

Next step: Log into your Router Running OpenWrt ->

docs/guide-quick-start/factory_installation.txt · Last modified: 2018/03/03 11:21 by coeneisma