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/12 22:19] – made page less overwelming: moved router mode to sub page 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}}
- +
-===== Prerequisites for these instructions=====  +
-If your situation doesn't match the criteria below, follow the links for more information: +
-  * You plan to install a "Release" build of LEDE. ([[docs:guide-quick-start:developmentinstallation|Or use this alternate procedure for a Development build...]])  +
-  * Your router has at least 8 MBytes of Flash and 64 MBytes of RAM ([[#why_we_require_8_mbytes_of_flash|Why is this important?]]) +
-  * If you have any questions about this process, or want to flash LEDE on another kind of device besides a router, please 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. +
- +
-===== Standard LEDE Installation ===== +
- +
-  - **Install (or "flash") the LEDE firmware image.** Use the [[docs:guide-quick-start:standardflashinginstructions|Standard Flashing Instructions]] to install LEDE on your device, then come back to finish these steps. +
-  - **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).  +
-    * //Note: Use 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.// +
-  - **Set up networking** we are now setting up networking to integrate it in your current network, the configuration varies depending on what is the role of the new LEDE device you are configuring.  +
-     - [[docs:user-guide:lede_as_clientdevice|as client device]]  If you want to connect your device to an existing network to provide additional functions (for example, you just want to use the Wi-Fi network it provides, or the device is a NAS serving files over the network, or a mini-server offering whatever other service). +
-     - [[docs:user-guide:lede_as_routerdevice|as router device]] If you want to run LEDE in its default router configuration, where LEDE routes between several LAN devices connected to the LEDE LAN ports and your Internet on the LEDE WAN port. +
-     - **Gateway device** If your device has a port labeled WAN or an integrated modem (supported by LEDE) and you want it to operate as a gateway (controlling a modem to give Internet access to all devices in a local network, usually a gateway is also a router for the local network).\\ Here Router settings as detailed above apply as in most cases the gateway is also the router in the same local network, but on the WAN port you either connect a modem in bridging, or you use an integrated modem. In either case, read the article about [[docs:user-guide:wan_interface_protocols|WAN interface protocols]] or look in your device's page. /* LINK TO A WIKI ARTICLE TO CONNECT MODEMS IN BRIDGING SHOULD ALSO GO HERE */ +
-  - **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** device, and adjust this command to set the same country code for all wireless radios in the device.  +
-  - **Congratulations!** Your device is now fully operational. +
- +
-===== Coming from sysupgrade ===== +
- +
-After a sysupgrade you must install again all the packages you installed before the sysupgrade, also enable them again if they added system services. +
-After you did so, you can restore the setting backup file you 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. +
- +
-===== Optional Next Steps ===== +
- +
-Once the device is workingyou can look through the [[:docs:user-guide:start|User Guide]] for ways to customize the device, or use any of these tips: +
-  * Set your default time zone from the **System** page. +
-  * Make your new LEDE device the primary router by connecting it directly to your cable/DSL modem. +
-  * Install other packages from the System -> Software page. Useful packages are snmpd, netperf, and any of your favorites. +
- +
-==== Why We Require 8 MBytes of Flash ==== +
- +
-This procedure is designed to //work every time// and create a fully-functional router, with GUI and a standard set of packages/capabilities.  Routers with 4 MBytes (or less) of Flash work, but usually require a firmware rebuild to include any additional packages you need. Those instructions are outside the scope of this procedure. +
- +
-If you are purchasing a new router to use with LEDE, we strongly recommend getting one with at least 8 MBytes of Flash memory, and 64 MBytes of RAM to ease installation, and to provide some measure of ability to expand in the future. +
- +
-If you wish to install LEDE on a device with less than 8/64 MBytes Flash/RAM, please 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]].+
  
  • Last modified: 2023/11/20 06:43
  • by netcog