[web] First cut at Getting Started page

LEDE Commits lede-commits at lists.infradead.org
Mon Jul 25 01:24:02 PDT 2016


blogic pushed a commit to web.git, branch master:
https://git.lede-project.org/?p=web.git;a=commitdiff;h=877773ea855caf91db195207b90d7a7d956b6073

commit 877773ea855caf91db195207b90d7a7d956b6073
Author: Rich Brown <richb.hanover at gmail.com>
AuthorDate: Sun Jul 17 14:09:33 2016 -0400

    First cut at Getting Started page
---
 _includes/docs_nav.html              |   4 +-
 docs/index.txt                       |  46 ++++++++---
 docs/transcript.txt                  | 149 +++++++++++++++++++++++++++++++++++
 docs/{index.txt => web_presence.txt} |   0
 4 files changed, 187 insertions(+), 12 deletions(-)

diff --git a/_includes/docs_nav.html b/_includes/docs_nav.html
index 8967779..50a8233 100644
--- a/_includes/docs_nav.html
+++ b/_includes/docs_nav.html
@@ -2,7 +2,7 @@
 <div class="panel">
     <div id="toc" class="toc">
         <ul class="sectlevel0">
-            <li{% if page.url == '/docs/' %} class="active"{% endif %}><a href="index.html">Overview</a></li>
+            <li{% if page.url == '/docs/' %} class="active"{% endif %}><a href="index.html">Getting Started</a></li>
             <li{% if page.url == '/docs/config.html' %} class="active"{% endif %}><a href="config.html">Configuration</a></li>
             <li{% if page.url == '/docs/ubus.html' %} class="active"{% endif %}><a href="ubus.html">uBus</a></li>
             <li{% if page.url == '/docs/procd.html' %} class="active"{% endif %}><a href="procd.html">Procd</a></li>
@@ -19,6 +19,8 @@
                 <li{% if page.url == '/docs/uci_system.html' %} class="active"{% endif %}><a href="uci_system.html">System</a></li>
                 <li{% if page.url == '/docs/uci_wireless.html' %} class="active"{% endif %}><a href="uci_wireless.html">Wireless</a></li>
             </ul>
+            <li{% if page.url == '/docs/web_presence.html' %} class="active"{% endif %}><a href="web_presence.html">This Web Presence</a></li>
+
         </ul>
     </div>
 </div>
diff --git a/docs/index.txt b/docs/index.txt
index 882ca1d..2933f5e 100644
--- a/docs/index.txt
+++ b/docs/index.txt
@@ -1,18 +1,42 @@
 ---
+layout: default
+title: Getting Started with LEDE
 ---
-Documentation Index
-===================
 
-== The Web Presence
+== Getting Started with LEDE
 
-The documentation  you're reading is generated from text files using the
-http://www.methods.co.nz/asciidoc/[AsciiDoc] suite. Any changes made to the
-project's documentation will be reflected in our +web.git+ repository:
+LEDE is based on link:https://wiki.openwrt.org/doc/start[OpenWrt] — most of the operational aspects of the two projects are identical. 
+This document frequently refers to pages of the OpenWrt wiki. 
 
-----
-git clone http://git.lede-project.org/web.git
-----
+Although there are many ways to install LEDE on your router and complete its initial configuration, the following steps are reliable:
 
-If you would like to contribute to the documentation then please send patches to our lede-dev mailing list and use the prefix "doc:" in the patch's subject.
+. *Flash the LEDE firmware image into your router.* The exact process is device-specific.
+Follow the OpenWrt links below to find the required information for your router:
+.. *Find your router's architecture and processor types.* 
+The "Device Page" of the link:https://wiki.openwrt.org/toh/start[OpenWrt Table of Hardware] will contain this information.
+.. *Download the proper LEDE firmware image to your computer* from link:https://downloads.lede-project.org/snapshots/targets/[downloads.lede-project.org.] 
+The directory structure for LEDE is identical to OpenWrt's downloads.
+.. *Follow the flashing instructions* on the OpenWrt Device Page.
+.. *Connect via Ethernet using DHCP.* After flashing, make sure your computer is connected to a Local Area Network (LAN) port of the router using DHCP.
+. *SSH to the router.* +
+In your terminal program, enter `ssh root at 192.168.1.1`. You can follow along with the steps below in the link:transcript.html[SSH Transcript].  
+. *Set the password.* +
+LEDE ships without a password. Enter `passwd` and type the new password twice. 
+_Note: Use a good password: it secures your home network.
+Write it on the bottom of the router so you don't forget._
+. *Connect the Wide Area Network (WAN) port of the router to "the internet".* +
+The router WAN port defaults to DHCP, so you can usually connect the new WAN port into your existing router's LAN port. The new router should then be "on the air."
+. *Confirm internet connectivity* +
+Type `ping 8.8.8.8` (that is Google's DNS server.) 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.
 
-Alternatively, pull requests can be opened against https://github.com/lede-project/web
+== Next Steps
+
+* Review the link:transcript.html[SSH Transcript] to see all the configuration messages above.
+* Enable Wi-Fi in the router (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.
\ No newline at end of file
diff --git a/docs/transcript.txt b/docs/transcript.txt
new file mode 100644
index 0000000..e76deca
--- /dev/null
+++ b/docs/transcript.txt
@@ -0,0 +1,149 @@
+---
+layout: default
+title: LEDE SSH Transcript
+---
+
+== LEDE Installation Transcript
+
+The steps below are a transcript of the SSH session starting with step #2. 
+
+.bash-3.2$ ssh root at 192.168.1.1
+----
+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)
+    \________\/    -----------------------------------------------------------
+
+----
+
+.root at lede:~# passwd
+----
+Changing password for root
+New password:
+Retype password:
+Password for root changed by root
+----
+.root at lede:~# ping 8.8.8.8
+----
+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
+----
+.root at lede:~# opkg update
+----
+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.
+----
+.root at lede:~# opkg install luci-ssl
+----
+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.
+----
+Success! Now the Web GUI is available at https://192.168.1.1
\ No newline at end of file
diff --git a/docs/index.txt b/docs/web_presence.txt
similarity index 100%
copy from docs/index.txt
copy to docs/web_presence.txt



More information about the lede-commits mailing list