Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
docs:guide-quick-start:factory_installation [2018/02/17 16:00] – ↷ Links adapted because of a move operation docs:guide-quick-start:factory_installation [2018/08/13 17:31] – [Flash the firmware] tmomas
Line 1: Line 1:
-====== Factory install: First-time installation of LEDE on a device ======+====== 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. Your device must still have the vendor firmware to be eligible for this so-called "factory installation" procedure.
  
   * If your device already has an older LEDE or OpenWrt firmware on it, refer to the [[docs:guide-quick-start:sysupgrade.luci|sysupgrade]] howto instead .   * If your device already has an older LEDE or OpenWrt firmware on it, refer to the [[docs:guide-quick-start:sysupgrade.luci|sysupgrade]] howto instead .
-  * If you have any questions about this description, ask for help on the [[https://forum.lede-project.org/c/installation|Installing and Using LEDE forum section]] before beginning.+  * If you have any questions about this description, ask for help on the [[https://forum.openwrt.org/c/installation|Installing and Using OpenWrt forum section]] before beginning. 
 +  * If you are an advanced user, you may want to [[docs:guide-quick-start:developmentinstallation|install an OpenWrt Development Snapshots]] instead 
  
 ===== Device selection =====  ===== Device selection ===== 
  
-  * Devices with >=8 MBytes Flash memory and >=64 MBytes RAM allow a full-featured LEDE installation with GUI. +  * Devices with >=8 MBytes Flash memory and >=64 MBytes RAM allow a full-featured OpenWrt 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. +  * Devices with 4 MByte or less Flash memory can install OpenWrt 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.+  * If you want to purchase a new router for OpenWrt, stick to devices with >=8 MBytes Flash memory and >=64 MBytes RAM.
  
-===== Locate and download the LEDE firmware =====+===== Locate and download the OpenWrt firmware =====
  
-  - On the [[toh:views:toh_fwdownload|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.+  - On the [[toh:views:toh_fwdownload|Table of Hardware: Firmware downloads]] page, locate your specific device. 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 OpenWrt installation experience.
   - 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.   - 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.
-  - 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"** file.+  - On this device-specific **Techdata** page, at the bottom locate the line called **"Firmware OpenWrt Install URL"** that links to a downloadable file called **"...factory.bin"** or **"...factory.img"** file.\\ Please mind that only 30% of all supported devices have "factory" in their installation image name. The other 70% have different names.
   - Download this file.   - Download this file.
  
-Troubleshooting: +==== 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: + 
-    - 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. +  * If you can not find "factory.bin" firmware file (true for 70% of all supported devices), 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: 
-    - 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)+    - On the OpenWrt Techdata page of the device, check the fields "Forum Topic URL" and "Comment" for any external links or comments regarding custom installation procedures. 
-    - Search the LEDE forum for existing discussion threads about the device name or open a new topic in the LEDE forum, asking for instructions. +    - Look for the corresponding device page in the OpenWrt wiki, if that has any custom installation descriptions. 
-  * If you can't find your device in the Table of Hardware, you can consult the [[https://forum.lede-project.org/c/installation|"Installing and Using LEDE" Forum]] for help. You can also try [[docs:guide-quick-start:alternate-directory-search|alternative ways to locate LEDE firmware images.]] +    - Search the OpenWrt forum for existing discussion threads about the device name or open a new topic in the OpenWrt forum, asking for instructions. 
-  * 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" file.+  * If you can't find your device in the Table of Hardware, you can consult the [[https://forum.openwrt.org/c/installation|"Installing and Using OpenWrt" Forum]] for help. You can also try [[docs:guide-quick-start:alternate-directory-search|alternative ways to locate OpenWrt firmware images.]] 
  
 ===== Verify the downloaded firmware file ===== ===== Verify the downloaded firmware file =====
Line 31: Line 33:
 This ensures that you have a 100% correct download and that you will not brick your device by applying a faulty download. This ensures that you have a 100% correct download and that you will not brick your device by applying a faulty download.
  
-  - Check your downloaded "...factory.bin" file according to [[docs:guide-quick-start:verify_firmware_checksum|checksum verification of downloaded LEDE firmware files]].+  - Check your downloaded "...factory.bin" file according to [[docs:guide-quick-start:verify_firmware_checksum|checksum verification of downloaded OpenWrt firmware files]].
   - Only continue with flashing, if the firmware checksum of your download matches the checksum stated on the download site!   - Only continue with flashing, if the firmware checksum of your download matches the checksum stated on the download site!
  
 Troubleshooting: 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 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 [[https://forum.lede-project.org/c/installation|"Installing and Using LEDE" Forum]] for help. Be sure to include the exact brand, model, and version of your device.+  * if the checksum step fails repeatedly, you can consult the [[https://forum.openwrt.org/c/installation|"Installing and Using OpenWrt" Forum]] for help. Be sure to include the exact brand, model, and version of your device.
  
 ===== Flash the firmware ===== ===== Flash the firmware =====
  
   - Connect to the device via Ethernet cable (Only fallback to wireless, if the device has no Ethernet connection options)   - Connect to the device via Ethernet cable (Only fallback to wireless, if the device has no Ethernet connection options)
-  - 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+  - Ensure that the OpenWrt firmware file that you are about to flash, matches your router model and is called **"....factory.bin"** (only true for 30% of all supported devices; **70% of devices have different image names**, see above), as you will use it to modify a vendor's **factory** firmware towards OpenWrt
-  -  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.+  -  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 OpenWrt.
   - 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.   - 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.
-  - The new firmware has been installed. Continue with the next section to check the result.+  - The new firmware has been installed. 
  
-===== Check flash result ===== +**[[docs:guide-quick-start:walkthrough_login|Next step: Log into your Router Running OpenWrt ->]]*
- +
-  - After your device has finished flashing and rebooting, check if you can access the LEDE web admin GUI of LEDE on LEDE's default IP address: http://192.168.1.1 +
-  - Login to the LEDE web GUI as "root" admin user with the password field empty +
-  - Go to the System->Administration page and define a new password in both fields, then click Save and Apply (at the bottom of the page). +
-  - This has verified that you can successfully use the LAN ports of your LEDE device. You now have a working LEDE device in its initial default configuration.  +
- +
-Troubleshooting: +
-  For this check only use an Ethernet cable, as WiFi is by default only enabled for devices that do not have Ethernet ports  +
-  If you have flashed a development/snapshot firmware of LEDE, you first need to manually enable the admin web GUI: [[docs:guide-quick-start:developmentinstallation|development installation guide]]. Or verify the result on snapshot builds by SSH-connecting to your LEDE device IP 192.168.1.1 +
-  * You can consult the troubleshooting section of the [[docs:user-guide:start|User Guide]], if you think that resetting LEDE's settings might help. +
-  You can consult the [[https://forum.lede-project.org/c/installation|Installing and Using LEDE forum section]], if something went wrong. Please provide specific details of your device and what you did so far and what you have attempted to fix it.+
  
-===== Next steps ===== 
  
-  * For a first quick Internet access test: If you have an existing router, connect the WAN port of your LEDE device to a LAN port of that router and confirm internet connectivity of your LEDE device with the following steps: 
-     * In the LEDE admin web GUI, go to Network -> Diagnostics and Click on "ping" button 
-     * or, if using LEDE SSH command line, you can use the command ''ping lede-project.org''  
-     * This should return "0% packet loss" if everything is allright with your Internet connection. 
-  * Decide, whether you want to use LEDE [[docs:user-guide:general-info:switch_router_gateway_and_nat| as switch,  router or gateway]] 
-  * **When using your LEDE device as a WiFi access point, remember to initially set your country code in the LEDE WiFi configuration, to properly comply with your country's WiFi legal regulation!**, e.g. see here for a first [[docs:guide-quick-start:basic_wifi|basic WiFi setup]]. 
-  * Consult the [[docs:user-guide:start|User Guide]] for more advanced configuration. 
-  * Install custom software packages that you might be interested in. 
  
-**Troubleshooting your first steps with the new LEDE device:** 
-  * Do not worry, if the 5 GHz WiFi does not seem to start immediately after having enabled it. It might be busy for 1-10 min scanning for weather radar, see [[docs:guide-quick-start:basic_wifi|basic WiFi setup]] for more background info.  
-  * Note that you can always run ''logread'' on the SSH command line, to gain more insight into what the device is currently doing or to diagnose any kind of problems.  
-  * If needed, you can also take a look at [[docs:guide-quick-start:ts-internetconnectivity|Troubleshooting Internet Connectivity]]. 
  
  • Last modified: 2024/12/12 18:31
  • by palebloodsky