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:sysupgrade.luci [2020/09/27 11:57] – [Upgrading OpenWrt firmware using LuCI] unify terminology, formatting vgaeteradocs:guide-quick-start:sysupgrade.luci [2023/01/17 12:46] – [Backup] link section vgaetera
Line 2: Line 2:
 Your device must already have an older OpenWrt firmware installed, to be eligible for this "sysupgrade" procedure. Your device must already have an older OpenWrt firmware installed, to be eligible for this "sysupgrade" procedure.
   * Alternatively refer to the [[docs:guide-quick-start:factory_installation|factory installation]] howto, to install OpenWrt on a device that still has vendor factory firmware on it.   * Alternatively refer to the [[docs:guide-quick-start:factory_installation|factory installation]] howto, to install OpenWrt on a device that still has vendor factory firmware on it.
-  * If your current OpenWrt installation does not have web interface installed or if you prefer to upgrade from the command line (upgrade from command line provides more fine-grained control), refer to [[docs:guide-user:installation:sysupgrade.cli|Upgrading OpenWrt from the Command Line]]. +  * If your current OpenWrt installation does not have web interface installed or if you prefer to upgrade from the command line (upgrade from command line provides more fine-grained control), refer to [[docs:guide-user:installation:sysupgrade.cli|Upgrading OpenWrt firmware using CLI]]. 
   * 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 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.
 +  * Be aware of major config incompatibilities and version compatibility [[docs:guide-quick-start:admingui_sysupgrade_keepsettings#upgrade_compatibility|Keep Settings and Upgrade Compatibility]]
 +
 +===== Backup =====
 +{{section>docs:guide-user:installation:sysupgrade.cli#backup&noheader&nofooter&noeditbutton}}
  
 ===== Locate and download the OpenWrt firmware ===== ===== Locate and download the OpenWrt firmware =====
Line 15: Line 19:
  
 ===== Verify firmware file and flash the firmware ===== ===== Verify firmware file and flash the firmware =====
-  - Connect to the device via Ethernet cable (Use wireless only, if the device has no Ethernet connection options) +  - Connect to the device via Ethernet cable (Only use wireless if the device has no Ethernet connection options) 
   - Log into the web interface and in the **System -> Backup/Flash Firmware** menu, go to the "Flash new firmware image" section.   - Log into the web interface and in the **System -> Backup/Flash Firmware** menu, go to the "Flash new firmware image" section.
   - **Uncheck**/clear the **"Keep settings"** checkbox especially for major version upgrades, so that new defaults will get applied. Keeping settings may be possible for minor upgrades, but there is always a risk of incompatible settings. (more info regarding the [[docs:guide-quick-start:admingui_sysupgrade_keepsettings|"Keep settings" checkbox]] and its use cases).   - **Uncheck**/clear the **"Keep settings"** checkbox especially for major version upgrades, so that new defaults will get applied. Keeping settings may be possible for minor upgrades, but there is always a risk of incompatible settings. (more info regarding the [[docs:guide-quick-start:admingui_sysupgrade_keepsettings|"Keep settings" checkbox]] and its use cases).
Line 29: Line 33:
   * 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.   * 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.
  
-===== Check flash result ===== +===== Post-upgrade steps ===== 
-  * After your device has finished flashing and rebooting, check if you can access the web interface **[[http://openwrt.lan/|LuCI]]** (or the IP that you know of).+  * After your device has finished flashing and rebooting, check if you can access the LuCI web interface (or the IP that you know of). 
 +  * See **Post-upgrade steps** in [[docs:guide-user:installation:sysupgrade.cli|Upgrading OpenWrt firmware using CLI]]
  
 Troubleshooting: Troubleshooting:
   * If you have flashed a development/snapshot firmware of OpenWrt, you first need to manually enable the web interface: [[docs:guide-quick-start:developmentinstallation|development installation guide]]. Or verify the result by SSH-connecting to your OpenWrt device.   * If you have flashed a development/snapshot firmware of OpenWrt, you first need to manually enable the web interface: [[docs:guide-quick-start:developmentinstallation|development installation guide]]. Or verify the result by SSH-connecting to your OpenWrt device.
-  * The router may have succeeded, but gotten a different IP address than you expected. Either scan your local network, check your regular router's status page (to find out about the IP address it has assigned to your OpenWrt device) or use [[docs:guide-user:troubleshooting:failsafe_and_factory_reset| failsafe mode]], to manually reset OpenWrt's settings (which includes the network settings)+  * The router may have succeeded, but gotten a different IP address than you expected. Either scan your local network, check your regular router's status page (to find out about the IP address it has assigned to your OpenWrt device) or use [[docs:guide-user:troubleshooting:failsafe_and_factory_reset|failsafe mode]], to manually reset OpenWrt's settings (which includes the network settings)
   * If you have checkmarked the "Keep settings" checkbox in the previous section and the system fails to boot after flashing, you need to consult the [[docs:guide-user:troubleshooting:failsafe_and_factory_reset|failsafe mode]], to manually reset all settings.   * If you have checkmarked the "Keep settings" checkbox in the previous section and the system fails to boot after flashing, you need to consult the [[docs:guide-user:troubleshooting:failsafe_and_factory_reset|failsafe mode]], to manually reset all settings.
   * Otherwise you need to start configuring from scratch. In this case, remember to properly **set your country code in the OpenWrt Wi-Fi configuration** again, to comply with your country's Wi-Fi legal regulation, e.g. see in [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]].   * Otherwise you need to start configuring from scratch. In this case, remember to properly **set your country code in the OpenWrt Wi-Fi configuration** again, to comply with your country's Wi-Fi legal regulation, e.g. see in [[docs:guide-quick-start:basic_wifi|basic Wi-Fi setup]].
- 
-See also: 
-[[docs:guide-user:troubleshooting:backup_restore|Backup and restore]], 
-[[docs:guide-user:additional-software:managing_packages|Managing packages]] 
  
  • Last modified: 2023/11/11 23:53
  • by efahlgren