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-user:luci:luci.essentials [2020/12/19 03:00] – [2. Providing encryption] apply changes vgaeteradocs:guide-user:luci:luci.essentials [2023/04/03 01:00] – [Offline installation] vgaetera
Line 1: Line 1:
 ====== LuCI essentials ====== ====== LuCI essentials ======
-{{section>meta:infobox:howto_links#cli_skills&noheader&nofooter&noeditbutton}}+{{section>meta:infobox:howto_links#basic_skills&noheader&nofooter&noeditbutton}}
  
 ===== Introduction ===== ===== Introduction =====
 While OpenWrt can be managed completely using SSH and the terminal, the LuCI WebUI makes many administration tasks easier. While OpenWrt can be managed completely using SSH and the terminal, the LuCI WebUI makes many administration tasks easier.
-The OpenWrt full releases, such as the current 18.06.x series, ship with the LuCI WebUI installed.+The OpenWrt full releases, such as the current 21.02.x series, ship with the LuCI WebUI installed.
 But for lower-memory devices, such as those with 4MBytes Flash and/or 32MBytes of RAM, the full install may fail because of lacking sufficient Flash memory so you will have to [[docs:guide-user:additional-software:imagebuilder|build your own image]] with LuCI included. But for lower-memory devices, such as those with 4MBytes Flash and/or 32MBytes of RAM, the full install may fail because of lacking sufficient Flash memory so you will have to [[docs:guide-user:additional-software:imagebuilder|build your own image]] with LuCI included.
 More info on this can be obtained [[docs:guide-user:additional-software:saving_space|here]]. More info on this can be obtained [[docs:guide-user:additional-software:saving_space|here]].
Line 10: Line 10:
 ===== Instructions ===== ===== Instructions =====
 ==== 1. Basic installation ==== ==== 1. Basic installation ====
-Connect to your router via SSH and install the packages.+Install the required packages.
  
 <code bash> <code bash>
Line 17: Line 17:
 </code> </code>
  
-Now you can open **[[http://openwrt.lan/|LuCI]]** interface.+Now you can open LuCI interface.
  
 ==== 2. Providing encryption ==== ==== 2. Providing encryption ====
-Connect to your router via SSH and install the packages.+Install the required packages.
  
 <code bash> <code bash>
Line 84: Line 84:
 uhttpd supports this; see the corresponding section of the [[docs:guide-user:services:webserver:uhttpd#embedded_lua|uHTTPd Web Server Configuration]] article on the UCI configuration of uhttpd. uhttpd supports this; see the corresponding section of the [[docs:guide-user:services:webserver:uhttpd#embedded_lua|uHTTPd Web Server Configuration]] article on the UCI configuration of uhttpd.
  
 +LuCI by default comes with the bootstrap theme. There are additional themes available and you can create your own if you wish - [[:docs:guide-user:luci:luci.themes]]
 ==== Configuration ==== ==== Configuration ====
   * ''[[docs:guide-user:services:webserver:uhttpd|/etc/config/uhttpd]]''   * ''[[docs:guide-user:services:webserver:uhttpd|/etc/config/uhttpd]]''
Line 105: Line 106:
 Currently LuCI on nginx is fully supported (maybe only in master snapshots for now, as of 16-Feb-2019). Currently LuCI on nginx is fully supported (maybe only in master snapshots for now, as of 16-Feb-2019).
 If any problem is found, report them to the [[https://forum.openwrt.org/t/luci-on-nginx-compile/14580|support forum]]. If any problem is found, report them to the [[https://forum.openwrt.org/t/luci-on-nginx-compile/14580|support forum]].
 +
 +=== LuCI on BusyBox httpd ===
 +If you have a very limited space then you can compile OpenWRT image with [[docs:guide-user:services:webserver:http.httpd|BusyBox httpd]] instead of uhttpd. LUCI works fine but you'll need some manual configuration. Also this setup is not widely used and tested.
 +If any problem is found, report them to the [[https://forum.openwrt.org/t/luci-on-busybox-httpd/84418|support forum]].
  
 ==== Offline installation ==== ==== Offline installation ====
Line 111: Line 116:
 === Basic === === Basic ===
   * [[packages:pkgdata:liblua5.1.5|liblua]]   * [[packages:pkgdata:liblua5.1.5|liblua]]
-  * [[packages:pkgdata:libubus20191227|libubus]]+  * [[packages:pkgdata:libubus20220601|libubus]]
   * [[packages:pkgdata:libubus-lua]]   * [[packages:pkgdata:libubus-lua]]
   * [[packages:pkgdata:libuci-lua]]   * [[packages:pkgdata:libuci-lua]]
Line 162: Line 167:
  
 # Fetch OpenWrt release # Fetch OpenWrt release
-eval $(ssh openwrt cat /etc/openwrt_release) +eval $(ssh "${OWRT_HOST}" cat /etc/os-release)
-if [ "${DISTRIB_RELEASE}" = "SNAPSHOT"+
-then OWRT_DIR="snapshots" +
-else OWRT_DIR="releases/${DISTRIB_RELEASE}" +
-fi+
  
 # LuCI packages and repos # LuCI packages and repos
-OWRT_URL="https://downloads.openwrt.org"+case "${VERSION_ID}" in 
 +(snapshot) OWRT_URL="https://downloads.${HOME_URL#*//}snapshots/" ;; 
 +(*) OWRT_URL="https://downloads.${HOME_URL#*//}releases/${VERSION_ID}/;; 
 +esac
 OWRT_CORE="libiwinfo libiwinfo-lua" OWRT_CORE="libiwinfo libiwinfo-lua"
-OWRT_COREURL="${OWRT_URL}/${OWRT_DIR}/targets/${DISTRIB_TARGET}/packages"+OWRT_COREURL="${OWRT_URL}targets/${OPENWRT_BOARD}/packages"
 OWRT_BASE="libjson-c2 liblua lua libuci-lua libubus libubus-lua uhttpd rpcd" OWRT_BASE="libjson-c2 liblua lua libuci-lua libubus libubus-lua uhttpd rpcd"
-OWRT_BASEURL="${OWRT_URL}/${OWRT_DIR}/packages/${DISTRIB_ARCH}/base"+OWRT_BASEURL="${OWRT_URL}packages/${OPENWRT_ARCH}/base"
 OWRT_LUCI="luci-base liblucihttp liblucihttp-lua luci-lib-ip luci-lib-nixio \ OWRT_LUCI="luci-base liblucihttp liblucihttp-lua luci-lib-ip luci-lib-nixio \
     luci-theme-bootstrap luci-mod-admin-full luci-lib-jsonc luci-mod-status \     luci-theme-bootstrap luci-mod-admin-full luci-lib-jsonc luci-mod-status \
     luci-mod-system luci-mod-network"     luci-mod-system luci-mod-network"
-OWRT_LUCIURL="${OWRT_URL}/${OWRT_DIR}/packages/${DISTRIB_ARCH}/luci"+OWRT_LUCIURL="${OWRT_URL}packages/${OPENWRT_ARCH}/luci"
  
 # Download packages from repos # Download packages from repos
Line 209: Line 213:
   * [[docs:guide-user:luci:luci.secure|Secure access to LuCI via SSH tunnel]]   * [[docs:guide-user:luci:luci.secure|Secure access to LuCI via SSH tunnel]]
   * [[docs:techref:luci|LuCI technical reference]]   * [[docs:techref:luci|LuCI technical reference]]
 +  * [[docs:guide-user:luci:luci.themes|LuCI Themes and how to change them]]
  
  • Last modified: 2024/10/27 22:35
  • by palebloodsky