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
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/11/20 06:43] (current) netcog
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, exact hardware version or generation numberat 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