Differences
This shows you the differences between two versions of the page.
|
doc:howto:luci.essentials [2013/02/22 07:08] mypopy |
doc:howto:luci.essentials [2013/05/04 14:17] (current) orca |
||
|---|---|---|---|
| Line 21: | Line 21: | ||
| </code> | </code> | ||
| - | ==== Minimalistic offline installation ==== | + | ==== Start the web server (uHTTPd) ==== |
| + | The web server software uHTTPd is a dependency of the LuCI package and automatically installed on your OpenWrt system, when you install LuCI. **After installation the webs server is not running!** You need to manually start the web server (uHTTPd): | ||
| + | <code> | ||
| + | /etc/init.d/uhttpd start | ||
| + | </code> | ||
| - | Download and transfer (e.g. using SCP) the packages listed below to your OpenWrt router onto the RAM disk in ''/tmp/luci-offline-packages'' | + | Now you should be able to connect to the web server serving LuCI at [[http://192.168.1.1|http://192.168.1.1]]. |
| - | <code>mkdir -p /tmp/luci-offline-packages; cd /tmp/luci-offline-packages</code> | + | |
| - | * liblua | ||
| - | * lua | ||
| - | * libuci-lua | ||
| - | * libubus-lua | ||
| - | * uhttpd | ||
| - | * luci-lib-ipkg | ||
| - | * luci-i18n-english | ||
| - | * luci-sgi-cgi | ||
| - | * luci-lib-core | ||
| - | * luci-lib-nixio | ||
| - | * luci-lib-sys | ||
| - | * luci-lib-web | ||
| - | * luci-proto-core | ||
| - | * luci-theme-base | ||
| - | * luci-theme-openwrt | ||
| - | * luci-mod-admin-core | ||
| - | * luci-mod-admin-full | ||
| - | and install them with: | + | ==== Enable the web server (uHTTPd) ==== |
| + | To make the web server being started automatically after each reboot, you need to //enable// it, i.e. register the web server in the start up scripts. | ||
| - | <code>for pkg in liblua lua libuci-lua libubus-lua uhttpd luci-lib-ipkg luci-i18n-english luci-sgi-cgi luci-lib-core luci-lib-nixio luci-lib-sys luci-lib-web luci-proto-core luci-theme-base luci-theme-openwrt luci-mod-admin-core luci-mod-admin-full; do opkg install /tmp/luci-offline-packages/$pkg*.ipk; done</code> | + | Enable automatic start at boot: |
| - | + | ||
| - | Additionally, the following packages are needed for basic wireless configuration: libiw, libiwinfo, libiwinfo-lua. | + | |
| - | + | ||
| - | ==== Start the LuCI (uHTTPd) server ==== | + | |
| - | + | ||
| - | Enable automatic start at boot and manually start the LuCI server: | + | |
| <code> | <code> | ||
| /etc/init.d/uhttpd enable | /etc/init.d/uhttpd enable | ||
| - | /etc/init.d/uhttpd start | ||
| </code> | </code> | ||
| - | |||
| - | You should now be able to connect using a web browser to your router at [[http://192.168.1.1|http://192.168.1.1]]. | ||
| Line 67: | Line 45: | ||
| ===== Administration ===== | ===== Administration ===== | ||
| FIXME TODO | FIXME TODO | ||
| - | |||
| - | ===== Encompassed Packages ===== | ||
| - | ''luci'' and ''luci-ssl'' are meta-packages. Here you see what they comprise, the sizes are in Bytes compiled for the ar71xx platform. They should differ too much from binaries compiled for other architectures. Also note, that with JFFS2 it is not possible to precisely predict the occupied space. | ||
| - | |||
| - | In case you want to use a different web server and not install ''httpd'' at all, do not install the meta-package because it includes ''uhttpd''. Install the individual components instead and a web server of your choice. The article [[doc/howto/http.overview]] shows you some choices from the repos. | ||
| - | |||
| - | ^ Name ^ Size ^ Description ^ | ||
| - | | luci | 779 | Meta package. Standard OpenWrt set including full and mini admin and the standard theme | | ||
| - | | uhttpd | 23778 | uHTTPd is a tiny single threaded HTTP server with TLS, CGI and Lua support. It is intended as a drop-in replacement for the Busybox HTTP daemon. | | ||
| - | | luci-mod-admin-full | 60827 | LuCI Administration - full-featured for full control | | ||
| - | | luci-mod-admin-core | 5257 | Web UI Core module | | ||
| - | | luci-theme-openwrt | 7226 | OpenWrt.org (default) | | ||
| - | | luci-i18n-english | 1252 | English | | ||
| - | | luci-app-firewall | 16630 | Firmware and Portforwarding application | | ||
| - | | firewall | 11603 | UCI based firewall for OpenWrt /etc/config/firewall /etc/firewall.user. Dependencies: iptables, iptables-mod-conntrack, iptables-mod-nat | | ||
| - | | luci-app-initmgr | 5713 | LuCI Initscript Management | | ||
| - | | libiwinfo | 25362 | Wireless information library with consistent interface for proprietary Broadcom, madwifi, nl80211 and wext driver interfaces. | | ||
| - | | luci-lib-ipkg | 2846 | LuCI IPKG/OPKG call abstraction library | | ||
| - | | luci-theme-base | 25065 | Common base for all themes | | ||
| - | | libnl-tiny | 14390 | This package contains a stripped down version of libnl | | ||
| - | | liblua | 81477 | Lua is a powerful light-weight programming language designed for extending applications. Lua is also frequently used as a general-purpose, stand-alone language. Lua is free software. This package contains the Lua shared libraries, needed by other programs. | | ||
| - | | lua | 9069 | Lua is a powerful light-weight programming language designed for extending applications. Lua is also frequently used as a general-purpose, stand-alone language. Lua is free software. This package contains the Lua language interpreter. (5.1.4-7) | | ||
| - | | luci-lib-web | 59695 | MVC Webframework | | ||
| - | | luci-lib-sys | 15795 | LuCI Linux/POSIX system library | | ||
| - | | luci-lib-nixio | 31683 | NIXIO POSIX library | | ||
| - | | luci-lib-core | 28096 | LuCI core libraries | | ||
| - | | luci-sgi-cgi | 2420 | CGI Gateway behind existing Webserver | | ||
| - | | luci-lib-lmo | 4714 | LuCI LMO I18N library | | ||
| - | ^ Additionally Required for HTTPS ^^^ | ||
| - | | luci-ssl | 782 | Meta package. Standard OpenWrt set including full and mini admin, the standard theme + HTTPS support | | ||
| - | | uhttpd-mod-tls | 5825 | The TLS plugin adds HTTPS support to uHTTPd. | | ||
| - | | uhttpd-mod-lua | 9178 | The Lua plugin adds a CGI-like Lua runtime interface to uHTTPd. | | ||
| - | | libcyassl | 69682 | CyaSSL is an SSL library optimized for small footprint, both on disk and for memory use. | | ||
| - | | px5g | 28480 | Px5g is a tiny standalone X.509 certificate generator. It's suitable to create key files and certificates in [[wp>Distinguished Encoding Rules|DER]] and [[wp>Privacy Enhanced Mail|PEM]] format for use with stunnel, uhttpd and others. | | ||
| - | ^ Internationalization and localization packages ^^^ | ||
| - | | luci-i18n-xxx | ????? | Please confer to [[http://i18n.luci.subsignal.org/pootle/]] for an overview of the translation progress. | | ||
| - | |||
| - | |||
| - | |||
| - | | **''Note:''** According to [[https://forum.openwrt.org/viewtopic.php?pid=135623#p135623|this post]] a ''mini-admin-package'' is no longer available | | ||
| - | |||
| ===== LuCI on other web servers ===== | ===== LuCI on other web servers ===== | ||
| Line 162: | Line 99: | ||
| /etc/init.d/lighttpd enable | /etc/init.d/lighttpd enable | ||
| /etc/init.d/lighttpd start | /etc/init.d/lighttpd start | ||
| + | </code> | ||
| + | |||
| + | Add the following for the server to listen on ipv4 and ipv6 | ||
| + | <code> | ||
| + | #Listen on ipv4 | ||
| + | $SERVER["socket"] == ":80" { | ||
| + | } | ||
| + | #Listen on ipv6 | ||
| + | $SERVER["socket"] == "[::]:80" { | ||
| + | server.use-ipv6 = "enable" | ||
| + | } | ||
| </code> | </code> | ||
| Line 190: | Line 138: | ||
| **NOTE / TODO**: Instead of opening a 2nd port for lighttpd it should be possible to activate the module "**mod_simple_vhost**" | **NOTE / TODO**: Instead of opening a 2nd port for lighttpd it should be possible to activate the module "**mod_simple_vhost**" | ||
| and serve your website (in a vhost) in friendly coexistence of LuCI via port 80... | and serve your website (in a vhost) in friendly coexistence of LuCI via port 80... | ||
| + | |||
| + | ===== Minimalistic offline installation ===== | ||
| + | |||
| + | Download and transfer (e.g. using SCP) the packages listed below to your OpenWrt router onto the RAM disk in ''/tmp/luci-offline-packages'' | ||
| + | <code>mkdir -p /tmp/luci-offline-packages; cd /tmp/luci-offline-packages</code> | ||
| + | |||
| + | * liblua | ||
| + | * lua | ||
| + | * libuci-lua | ||
| + | * libubus-lua | ||
| + | * uhttpd | ||
| + | * luci-lib-ipkg | ||
| + | * luci-i18n-english | ||
| + | * luci-sgi-cgi | ||
| + | * luci-lib-core | ||
| + | * luci-lib-nixio | ||
| + | * luci-lib-sys | ||
| + | * luci-lib-web | ||
| + | * luci-proto-core | ||
| + | * luci-theme-base | ||
| + | * luci-theme-openwrt | ||
| + | * luci-mod-admin-core | ||
| + | * luci-mod-admin-full | ||
| + | |||
| + | and install them with: | ||
| + | |||
| + | <code>for pkg in liblua lua libuci-lua libubus-lua uhttpd luci-lib-ipkg luci-i18n-english luci-sgi-cgi luci-lib-core luci-lib-nixio luci-lib-sys luci-lib-web luci-proto-core luci-theme-base luci-theme-openwrt luci-mod-admin-core luci-mod-admin-full; do opkg install /tmp/luci-offline-packages/$pkg*.ipk; done</code> | ||
| + | |||
| + | Additionally, the following packages are needed for basic wireless configuration: libiw, libiwinfo, libiwinfo-lua. | ||
| ===== Troubleshooting ===== | ===== Troubleshooting ===== | ||
doc/howto/luci.essentials.1361513307.txt.bz2 · Last modified: 2013/02/22 07:08 by mypopy