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-newcomer [2016/10/06 16:39] – ↷ Page moved from playground:experiment:docs:guide-newcomer to docs:guide-newcomer richb-hanoverdocs:guide-quick-start:start [2023/03/09 03:23] – Specify that products with the same model name may have different generation no. brlin
Line 1: Line 1:
-====== Newcomer's 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(and if applicable, generation no.) 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.
  
-===== First steps =====+If you have any questions: 
 +  * Browse this site, especially 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.
  
-Although there are many ways to install LEDE on your device and complete its initial configuration, the following steps are reliable:+==== Quick start guide article list ==== 
 +{{pagequery>* ns:.;sort=ns,title;group;display={title};hidestart;hidejump}}
  
-  - **Flash the LEDE firmware image.** The exact process is device-specific. Use the OpenWrt links (below) to find the required information for your device, then download the proper LEDE firmware image: 
-    * **Find your device's information**  from the //OpenWrt Device Page// found on the //Table of Hardware// at https://wiki.openwrt.org/toh/start 
-    * **Download the proper LEDE firmware image to your computer** from downloads.lede-project.org https://downloads.lede-project.org/snapshots/targets/ The directory structure for LEDE matches the OpenWrt download directories. 
-    * **Follow the flashing instructions** on the //OpenWrt Device Page//. 
-  - **Connect to the newly-flashed device via Ethernet using DHCP** It is important to use an Ethernet connection, even if you flashed using Wi-Fi. 
-    * //On routers:// Connect your computer to a Local Area Network (LAN) port of the router using DHCP. 
-    * //On other devices:// The newly-flashed device will acquire an address using DHCP. Check your existing router’s web-interface to learn which address it got. 
-  - **SSH to the new LEDE device.** In your terminal program, enter ''ssh root@192.168.1.1'' You can follow along with these steps below in the transcript (below).   
-  - **Set the password.** LEDE ships without a password. Enter ''passwd'' and type the new password twice. //Note: Use a good password: it the protection for your home network. Write it on the bottom of the device so you don't forget.// 
-  - **Connect the Wide Area Network (WAN) port of the device to "the internet".** LEDE's WAN port defaults to DHCP, so you can usually 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.** We recommend the SSL-based package, but you could use the non-SSL version (named 'luci', not 'luci-ssl'). 
-    * Enter ''opkg update'' 
-    * Enter ''opkg install luci-ssl'' to get the SSL-based web GUI.  
-  - **At this point, the Web GUI is available.** Go to https://192.168.1.1 to complete configuration. 
- 
-===== Next Steps ===== 
- 
-  * Review the transcript (below) to see all the messages from the configuration commands above. 
-  * Enable Wi-Fi in the device (LEDE ships with Wi-Fi turned off). See *Network -> Wireless* in the Web GUI. 
-  * Install other packages with ''opkg install ...'' Useful packages are snmpd, netperf, luci-app-sqm, and any of your favorites. 
- 
-===== 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