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/01/17 01:41] – remove luci-ssl in favor of luci; refer non-router people to forums; editorial pass & fix typos richb-hanoverdocs: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 ======+====== Quick start guide for OpenWrt installation ====== 
 +So you want to install OpenWrt on one of your devices.
  
-LEDE is based on OpenWrt (https://wiki.openwrt.org/doc/start) -- most of the operational aspects of the two projects are identical.  +The following preparation is recommended, before flashing OpenWrt firmware: 
-If you have questionsyou can search this wiki, or look at the pages of the OpenWrt wiki+  * 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 handon how to flash new firmware. 
 +  * When installing and configuring OpenWrt on your Internet routeryour 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.
  
-<WRAP info> +If you have any questions: 
-//LEDE is evolving rapidly. As of late 2016it is probably not stable enough for your family to use as the primary routerWe are working hard towards a stable release in the new year.//+  * 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.
  
-//However, if you are willing to live with occasional bugs and instability, you can help us improve LEDE by installing and testing our builds, reporting issues and sending fixes.//  +==== Quick start guide article list ==== 
-</WRAP>+{{pagequery>* ns:.;sort=ns,title;group;display={title};hidestart;hidejump}}
  
-===== Standard LEDE Installation ===== 
-The steps below install LEDE firmware on a router. At the completion of this procedure, your router will have a functioning connection to the internet, with a strong password, attractive web GUI, and functioning Wi-Fi (if desired). 
- 
-If you have any questions about this process, or if you want to flash LEDE on another kind of device besides a router, please ask on the [[https://forum.lede-project.org/c/installation|Installing and Using LEDE]] category of the [[https://forum.lede-project.org/c/installation|forum]]. 
- 
-  - **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 to the newly-flashed device via Ethernet using DHCP** It is important to use an Ethernet connection, even if you flashed using Wi-Fi. Configure your computer to get a DHCP address: the default IP address for the router is 192.168.1.1. 
-  - **SSH to the new LEDE device.** In your terminal program, enter ''ssh root@192.168.1.1'' //The transcript (at the bottom of this page) shows the responses to your typed commands.// 
-  - **Set the password.** LEDE ships without a password. When you see the ''root@lede:~#'' prompt, enter ''passwd'' and type the new password twice. //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 ssh in the future.// 
-  - **Connect the Wide Area Network (WAN) port of the newly-flashed device to “the internet”.** LEDE's WAN port defaults to DHCP, so you can usually use another Ethernet cable to connect the WAN port of your new device into a LAN port of your existing router. You should then be “on the air.” 
-  - **Confirm internet connectivity** with Google's DNS server. Type ''ping 8.8.8.8'' If the previous step worked, you should see ping response messages. 
-  - **Update the packages, then install the LuCI web configuration package.** (luci is already installed for a stable release. But it will never cause a problem to do it again.)  
-    * Enter ''opkg update'' 
-    * Enter ''opkg install luci'' to get the web GUI.  
-  - **At this point, the Web GUI is available.** Go to http://192.168.1.1 to complete configuration. 
-  - **Enable Wi-Fi in the device** For security, LEDE ships with Wi-Fi turned off. Go to **Network -> Wireless** in the Web GUI to enable Wi-Fi.  
-  - **Congratulations!** Your device is now a fully operational router. 
- 
-===== Optional Next Steps ===== 
- 
-Once the device is working, you can look through the [[:docs:user-guide:start|User Guide]] for ways to customize the device, or use any of these tips: 
-  * Install other packages with ''opkg install ...'' Useful packages are snmpd, netperf, luci-app-sqm, and any of your favorites. 
-  * If you want your device to behave as an access point, read [[:docs:user-guide:router-vs-accesspoint|Router vs. Access Point.]] 
-  * If you have an unbranded / low-end / low-cost router that came shipped with OpenWrt / LEDE, you can find out the architecture it is using by connecting to it over ssh and opening ''/proc/cpuinfo''. A combination of the ''system type'' and ''machine'' is what you are looking for. 
-  * If you will be flashing LEDE frequently, you can create a script that makes configuration changes in a reliable and repeatable fashion. See, for example, the [[https://github.com/richb-hanover/OpenWrtScripts/blob/master/config-openwrt.sh|config-openwrt.sh]] script that updates most settings. Once you have the script, it could replace steps 4-7 above. 
-===== Transcript from LEDE Installation ===== 
- 
-The steps below are a transcript of the SSH session starting with step #3. 
- 
-**bash-3.2$ ssh root@192.168.1.1** 
-<code> 
-The authenticity of host '192.168.1.1 (192.168.1.1)' can't be established. 
-RSA key fingerprint is 33:df:77:e6:b4:a2:bd:33:a2:4c:53:3b:e8:0f:b8:9c. 
-Are you sure you want to continue connecting (yes/no)? yes 
-Warning: Permanently added '192.168.1.1' (RSA) to the list of known hosts. 
- 
-BusyBox v1.24.2 () built-in shell (ash) 
-     _________ 
-    /        /\      _    ___ ___  ___ 
-   /  LE    /  \    | |  | __|   \| __| 
-  /    DE  /    \   | |__| _|| |) | _| 
- /________/  LE  \  |____|___|___/|___|                      lede-project.org 
-        \   DE / 
-  \    LE  \    /  ----------------------------------------------------------- 
-    DE    \  /    Reboot (HEAD, r1006) 
-    \________\/    ----------------------------------------------------------- 
-</code> 
-**root@lede:~# passwd** 
-<code> 
-Changing password for root 
-New password: 
-Retype password: 
-Password for root changed by root 
-</code> 
- 
-**root@lede:~# ping 8.8.8.8** 
-<code> 
-PING 8.8.8.8 (8.8.8.8): 56 data bytes 
-64 bytes from 8.8.8.8: seq=0 ttl=53 time=20.888 ms 
-64 bytes from 8.8.8.8: seq=1 ttl=53 time=21.107 ms 
-^C 
---- 8.8.8.8 ping statistics --- 
-2 packets transmitted, 2 packets received, 0% packet loss 
-round-trip min/avg/max = 20.888/20.997/21.107 ms 
-</code> 
- 
-**root@lede:~# opkg update** 
-<code> 
-Downloading http://downloads.lede-project.org/snapshots/targets/ramips/mt7621/packages/Packages.gz. 
-Updated list of available packages in /var/opkg-lists/reboot_core. 
-Downloading http://downloads.lede-project.org/snapshots/targets/ramips/mt7621/packages/Packages.sig. 
-Signature check passed. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/Packages.gz. 
-Updated list of available packages in /var/opkg-lists/reboot_base. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/Packages.sig. 
-Signature check passed. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/Packages.gz. 
-Updated list of available packages in /var/opkg-lists/reboot_luci. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/Packages.sig. 
-Signature check passed. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/packages/Packages.gz. 
-Updated list of available packages in /var/opkg-lists/reboot_packages. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/packages/Packages.sig. 
-Signature check passed. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/routing/Packages.gz. 
-Updated list of available packages in /var/opkg-lists/reboot_routing. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/routing/Packages.sig. 
-Signature check passed. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/telephony/Packages.gz. 
-Updated list of available packages in /var/opkg-lists/reboot_telephony. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/telephony/Packages.sig. 
-Signature check passed. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/targets/Packages.gz. 
-Updated list of available packages in /var/opkg-lists/reboot_targets. 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/targets/Packages.sig. 
-Signature check passed. 
-</code> 
-**root@lede:~# opkg install luci-ssl** 
-<code> 
-Installing luci-ssl (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-ssl_git-16.190.47901-6be6904-1_all.ipk. 
-Installing luci (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci_git-16.190.47901-6be6904-1_all.ipk. 
-Installing uhttpd (2016-06-16-9d9f07142bbef1c63a79620967a847a9493105e5) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/uhttpd_2016-06-16-9d9f07142bbef1c63a79620967a847a9493105e5_mipsel_1004kc_dsp.ipk. 
-Installing uhttpd-mod-ubus (2016-06-16-9d9f07142bbef1c63a79620967a847a9493105e5) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/uhttpd-mod-ubus_2016-06-16-9d9f07142bbef1c63a79620967a847a9493105e5_mipsel_1004kc_dsp.ipk. 
-Installing luci-mod-admin-full (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-mod-admin-full_git-16.190.47901-6be6904-1_mipsel_1004kc_dsp.ipk. 
-Installing luci-base (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-base_git-16.190.47901-6be6904-1_mipsel_1004kc_dsp.ipk. 
-Installing lua (5.1.5-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/lua_5.1.5-1_mipsel_1004kc_dsp.ipk. 
-Installing liblua (5.1.5-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/liblua_5.1.5-1_mipsel_1004kc_dsp.ipk. 
-Installing libuci-lua (2016-07-04.1-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/libuci-lua_2016-07-04.1-1_mipsel_1004kc_dsp.ipk. 
-Installing luci-lib-nixio (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-lib-nixio_git-16.190.47901-6be6904-1_mipsel_1004kc_dsp.ipk. 
-Installing luci-lib-ip (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-lib-ip_git-16.190.47901-6be6904-1_mipsel_1004kc_dsp.ipk. 
-Installing rpcd (2016-06-30-23417e94d25570e6d62542bac46edd51e8e0243a) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/rpcd_2016-06-30-23417e94d25570e6d62542bac46edd51e8e0243a_mipsel_1004kc_dsp.ipk. 
-Installing libubus-lua (2016-07-02-053be7df871e05478284235732f8b0608089512f) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/libubus-lua_2016-07-02-053be7df871e05478284235732f8b0608089512f_mipsel_1004kc_dsp.ipk. 
-Installing luci-lib-jsonc (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-lib-jsonc_git-16.190.47901-6be6904-1_mipsel_1004kc_dsp.ipk. 
-Installing luci-theme-bootstrap (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-theme-bootstrap_git-16.190.47901-6be6904-1_all.ipk. 
-Installing luci-app-firewall (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-app-firewall_git-16.190.47901-6be6904-1_all.ipk. 
-Installing luci-proto-ppp (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-proto-ppp_git-16.190.47901-6be6904-1_all.ipk. 
-Installing libiwinfo-lua (2016-07-04-96d322d5941c57be58f8e8d5c6e2b28e90ed3598) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/libiwinfo-lua_2016-07-04-96d322d5941c57be58f8e8d5c6e2b28e90ed3598_mipsel_1004kc_dsp.ipk. 
-Installing luci-proto-ipv6 (git-16.190.47901-6be6904-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/luci/luci-proto-ipv6_git-16.190.47901-6be6904-1_all.ipk. 
-Installing libustream-polarssl (2016-07-02-ec80adaa1b47f28d426fa19c692011ce60b992d6) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/libustream-polarssl_2016-07-02-ec80adaa1b47f28d426fa19c692011ce60b992d6_mipsel_1004kc_dsp.ipk. 
-Installing libpolarssl (1.3.17-1) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/libpolarssl_1.3.17-1_mipsel_1004kc_dsp.ipk. 
-Installing px5g-polarssl (4) to root... 
-Downloading http://downloads.lede-project.org/snapshots/packages/mipsel_1004kc_dsp/base/px5g-polarssl_4_mipsel_1004kc_dsp.ipk. 
-Configuring liblua. 
-Configuring libuci-lua. 
-Configuring rpcd. 
-Configuring luci-lib-ip. 
-Configuring libubus-lua. 
-Configuring libiwinfo-lua. 
-Configuring luci-theme-bootstrap. 
-Configuring luci-app-firewall. 
-Configuring libpolarssl. 
-Configuring px5g-polarssl. 
-Configuring lua. 
-Configuring uhttpd. 
-Generating RSA private key, 2048 bit long modulus 
-Generating selfsigned certificate with subject 'C=ZZ,ST=Somewhere,L=Unknown,CN=LEDE,' and validity 20160717161519-20180717161519 
-Configuring uhttpd-mod-ubus. 
-Configuring luci-lib-nixio. 
-Configuring luci-lib-jsonc. 
-Configuring luci-base. 
-Configuring luci-mod-admin-full. 
-Configuring luci-proto-ppp. 
-Configuring luci-proto-ipv6. 
-Configuring luci. 
-Configuring libustream-polarssl. 
-Configuring luci-ssl. 
-</code> 
-**Success!** Now the Web GUI is available at https://192.168.1.1 
  • Last modified: 2023/11/20 06:43
  • by netcog