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:start [2017/08/13 18:27] – link text improved alxdocs:guide-quick-start:start [2021/08/02 19:04] – [Quick start guide for OpenWrt installation] vgaetera
Line 1: Line 1:
-====== Quick Start Guide - Installing LEDE Release ======+====== Quick start guide for OpenWrt installation ====== 
 +So you want to install OpenWrt on one of your devices.
  
-The steps below install a stable "release" build of LEDE firmware on a routerRelease images of LEDE have a Web GUI and are designed to be used at home where members of your family rely on the network+The following preparation is recommended, before flashing OpenWrt firmware
 +  * Don't rush the installation, take your timeIf something seems weird during installation, find answers first before continuing. 
 +  * Have your device's precise model name at hand, so you are able to select the correct OpenWrt firmware. 
 +  * Have your device's documentation at hand, on how to flash new firmware. 
 +  * When installing and configuring OpenWrt on your Internet router, your Internet-access will obviously be offline for a few minutes. Please ensure that you have all required information offline or have backup Internet access at hand in this time.
  
-At the completion of this procedureyour router will connect to the internet, have a strong password, provide a powerful and attractive web GUI, and enable Wi-Fi.+If you have any questions: 
 +  * Browse this siteespecially the [[docs:guide-user:start|user-guide]] section. 
 +  * Feel free to ask in the [[:contact#forum|OpenWrt forum]]. 
 +  * You can also consult the [[:historicalwiki|old OpenWrt wiki]] if you are looking for legacy information. 
 +  * Follow the [[docs:guide-quick-start:factory_installation|factory install how-to]] to install OpenWrt on your device.
  
-LEDE is based on OpenWrt (https://wiki.openwrt.org/doc/start) -- most of the operational aspects of the two projects are identical.  +==== Quick start guide article list ==== 
-If you have questions, you can search this site, search the [[https://forum.lede-project.org|LEDE Forum]], or look at the pages of the [[https://wiki.openwrt.org|OpenWrt wiki.]] +{{pagequery>* ns:.;sort=ns,title;group;display={title};hidestart;hidejump}}
- +
-===== 1. Prerequisites =====  +
- +
-  * This quick start guide is meant for official "Release" build of LEDE ([[docs:guide-quick-start:developmentinstallation|Separate guide for development builds]])  +
-  * Your router should have at least 8 MBytes of Flash ROM and 64 MBytes of RAM. This allows to apply a full-featured LEDE firmware with GUI, a standard set of packages/capabilities and the ability to install optional packages.  +
-  * LEDE packages for routers with 4 MBytes (or less) Flash ROM are also available, but cover only a small set of included features and tools. Installation of optional packages is either not possible or very restricted on such routers, due to limited free space. You can create individual custom images for your needs, but such customization takes more effort and is not covered in this quick start guide. +
-  * If you want to purchase a new router to use for LEDE, we therefore strongly recommend getting one with at least 8 MBytes of Flash memory and 64 MBytes of RAM, to allow installation of all the optional packages that you may need right now and to provide enough headroom for expansion in the future. +
-  * If you have any questions about this quick start or want to create custom firmware images for devices with less than 8MB of Flash or other kind of devices besides routers, you can ask for help on the [[https://forum.lede-project.org/c/installation|Installing and Using LEDE]] category of the [[https://forum.lede-project.org/c/installation|forum]] before beginning this procedure. +
- +
-===== 2. Flashing the LEDE Firmware ===== +
- +
-  * Optional: If you are upgrading from a previous LEDE version, you can save (and later restore) the previous configuration before flashing, by using the backup function in LuCi's **backup/flash firmware** menu. (otherwise the old configuration will be lost) +
-  * Use the [[docs:guide-quick-start:standardflashinginstructions|Standard Flashing Instructions]] to install LEDE on your device, then come back to finish the configuration. +
- +
-===== 3a. First Time Configuration ===== +
- +
-  - **Connect your computer directly to the newly-flashed device via Ethernet using a dynamic address** if you haven't already done so. Wi-Fi is disabled by default in devices that have Ethernet ports (while devices with only Wi-Fi connectivity will have it enabled of course).  +
-  - **Go to the device's default address http://192.168.1.1** to complete configuration. You will see the LEDE Login page. +
-  - **Set the password.** LEDE ships without a password, and you must set it before you can proceed. To do this: +
-    * Set the Username to "root", leave the password field empty, and click "Login". You will go to the System->Administration page. +
-    Enter the new password in both fields, then click Save and Apply (at the bottom of the page).  +
-    * //NoteUse a good password: it is the first line of defense for your home network. Write the username ("root") and password, and the IP address of the router, on a sticker on the bottom of the device so you don't forget. Use the username and password for any other access through Luci and ssh in the future.// +
-  - You should decide, whether you want to use LEDE [[docs:user-guide:switch_router_gateway_and_nat| as switch,  router or gateway ]]. +
-  - **Confirm internet connectivity of your device:** Go to Network -> Diagnostics and Click on "ping" button (or write ''ping lede-project.org'' from command line ) - it should print "0% packet loss" if all is right.\\ If you cannot connect to the internet, review the steps at [[:docs:guide-quick-start:ts-internetconnectivity|Troubleshooting Internet Connectivity.]] +
-  - **Enable Wi-Fi in the device.** Devices that have ethernet ports have Wi-Fi turned off by default. Go to **Network -> Wireless** in the Web GUI to enable and configure Wi-Fi. /*WOULD BE COOL TO HAVE WIFI CONFIG TUTORIAL TOO HERE*/ +
-  - **Set your Country for the Wi-Fi**. This is important to ensure your router meets legal regulations in your country.  +
-    * **From Luci**:  +
-      - **Network** -> **Wireless**  +
-      - click on **Edit** for the first Wi-Fi network (if you have more than one you must do this for all others too) +
-      - in **Device Configuration**, click on **Advanced Settings**, then select the correct country in **Country Code** field.  +
-      - Click **Save & Apply** when done. +
-    * **From Command line**: +
-      - write ''uci show wireless'' to see all the wireless configuration and how many Wi-Fi chips (called "radio" in the config) there are on the device +
-      - find your country in a list of ISO/IEC 3166 alpha2 country codes. There is a list on the wikipedia article about [[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2|ISO 3166-1 alpha-2]] +
-      - type ''uci set wireless.radio0.country='XX''' to set the country code **XX** for **radio0** deviceand adjust this command to set the same country code for all wireless radios in the device.  +
-  - **Congratulations!** Your device is now fully operational. +
-  - If you like, you can now go through the [[:docs:user-guide:start|User Guide]] for further ways to customize the device. +
- +
-===== 3b. Configuration, if LEDE has been upgraded from a previous LEDE version ===== +
- +
-If you don't want to start from scratch, but want LEDE to get back to the same configuration state as before the upgrade: +
-  * After a sysupgrade, all the packages you had installed before the sysupgrade must be installed again using ''opkg'' (and enabled, if they added system services). +
-  * After you did so, you can restore the setting backup file you have generated before the upgrade from Luci's System -> Backup/Flash Firmware page. +
-  * You might also want to check [[docs:user-guide:ssh-firmware-upgrade|Installing LEDE from the Command Line]] if you want to see what are the differences between new/old config files or do other advanced-user tasks.+
  
  • Last modified: 2023/11/20 06:43
  • by netcog