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 [2016/10/26 16:06] – [Next Steps] 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.
  
-===== First steps ===== +If you have any questions: 
-  **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+  * Browse this site, especially the [[docs:guide-user:start|user-guide]] section
-  **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. +  * Feel free to ask in the [[:contact#forum|OpenWrt forum]]
-    * //On routers:// Connect your computer to a Local Area Network (LAN) port of the router using DHCP. +  * You can also consult the [[:historicalwiki|old OpenWrt wiki]] if you are looking for legacy information
-    * //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+  * Follow the [[docs:guide-quick-start:factory_installation|factory install how-to]] to install OpenWrt on your device.
-  **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. //NoteUse a good password: it the protection for your home networkWrite 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 =====+==== Quick start guide article list ==== 
 +{{pagequery>* ns:.;sort=ns,title;group;display={title};hidestart;hidejump}}
  
-  * 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. 
-  * 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