LuCI Essentials - OpenWrt Wiki

http://wiki.openwrt.org/doc/howto/luci.essentials

LuCI Essentials
This installs merely the essentials of the Web User Interface LuCI. There are many more (small) packages: opkg list luci-* to administer OpenWrt with packages.

Preparation
Prerequisites
Firewall: uhttpd listens on Ports 80 TCP and 443 TCP for incoming connections.

Required Packages
Name luci uhttpd luci-modadmin-full luci-modadmin-core luci-themeopenwrt luci-i18n-english luci-app-firewall firewall luci-app-initmgr libiwinfo luci-lib-ipkg luci-theme-base libnl-tiny liblua Size Description 779 Meta package. Standard OpenWrt set including full and mini admin and the standard theme 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.

60827 LuCI Administration - full-featured for full control 5257 Web UI Core module 7226 OpenWrt.org (default) 1252 English 16630 Firmware and Portforwarding application 11603 UCI based firewall for OpenWrt /etc/config/firewall /etc/firewall.user. Dependencies: iptables, iptablesmod-conntrack, iptables-mod-nat

5713 LuCI Initscript Management 25362 Wireless information library with consistent interface for proprietary Broadcom, madwifi, nl80211 and wext driver interfaces.

2846 LuCI IPKG/OPKG call abstraction library 25065 Common base for all themes 14390 This package contains a stripped down version of libnl Lua is a powerful light-weight programming language designed for extending applications. Lua is also 81477 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 is a powerful light-weight programming language designed for extending applications. Lua is also 9069 frequently used as a general-purpose, stand-alone language. Lua is free software. This package contains the Lua language interpreter. (5.1.4-7) 59695 MVC Webframework 28096 LuCI core libraries 15795 LuCI Linux/POSIX system library

lua luci-lib-web luci-lib-core luci-lib-sys

1 of 4

05/11/2011 12:27 AM

LuCI Essentials - OpenWrt Wiki

luci-lib-nixio luci-lib-core luci-sgi-cgi luci-lib-lmo 31683 NIXIO POSIX library 28096 LuCI core libraries 2420 CGI Gateway behind existing Webserver 4714 LuCI LMO I18N library

http://wiki.openwrt.org/doc/howto/luci.essentials

Additionally Required for HTTPS luci-ssl uhttpd-mod-tls libcyassl px5g 782 Meta package. Standard OpenWrt set including full and mini admin, the standard theme + HTTPS support 5825 The TLS plugin adds HTTPS support to uHTTPd. 69682 CyaSSL is an SSL library optimized for small footprint, both on disk and for memory use. Px5g is a tiny standalone X.509 certificate generator. It's suitable to create key files and certificates in DER 28480 [http://en.wikipedia.org/wiki/Distinguished Encoding Rules] and PEM [http://en.wikipedia.org/wiki/Privacy Enhanced Mail] format for use with stunnel, uhttpd and others.

Internationalization and localization packages luci-i18n-russian luci-i18nportuguese luci-i18n-malay luci-i18nnorwegian luci-i18n-italian luci-i18n-spanish luci-i18njapanese luci-i18n-german luci-i18n-greek luci-i18n-catalan luci-i18n-french luci-i18nvietnamese luci-i18n-english 8982 Russian (by Skryabin Dmitry) 11153 Portuguese (by Jose Monteiro) 10959 Malay (by Teow Wai Chet) 11715 Norwegian (by Lars Hardy) 9639 Italian (by Matteo Croce) 11141 Spanish (by Guillermo Javier Nardoni) 16223 Japanese (by Tsukasa Hamano) 17133 German 13166 Greek (by Vasilis Tsiligiannis) 11193 Catalan (by Eduard Duran) 8982 French (by Florian Fainelli) 10461 Vietnamese (by Hong Phuc Dang) 1252 English

NOTE: These are all packages with all their dependencies needed by the WebUI. A total of 461773 Bytes on ar71xx platforms. The package luci-app-firewall is needed, and it depends on the package firewall and this has itself some additional dependencies: iptables, iptables-mod-conntrack, iptables-mod-nat. Check http://i18n.luci.subsignal.org/i18n/projects/luci/ [http://i18n.luci.subsignal.org/i18n/projects/luci/] for an overview of the translation progress. Do we need:
uhttpd-mod-lua 9178 The Lua plugin adds a CGI-like Lua runtime interface to uHTTPd.

Installation
opkg Do 2 of 4 05/11/2011 12:27 AM

LuCI Essentials - OpenWrt Wiki

opkg update

http://wiki.openwrt.org/doc/howto/luci.essentials

then for LuCI without HTTPS support

opkg install luci

and for LuCI with HTTPS support

opkg install luci-ssl

then continue with

/etc/init.d/uhttpd enable /etc/init.d/uhttpd start netstat -a iptables -I INPUT -j ACCEPT -i eth0.1 -p tcp --dport 80 iptables -I INPUT -j ACCEPT -i eth0.1 -p tcp --dport 443

You should now be able to connect with a webbrowser. Above firewall rules can also be realized with UCI: opening.ports.

Configuration
Use the file /etc/???? /www/??? to configure. Also see uhttpd.
... ...

Start on boot
To enable/disable start on boot:

/etc/init.d/uhttpd enable this simply creates a symlink: /etc/rc.d/S..uhttpd /etc/init.d/uhttpd /etc/init.d/uhttpd disable this removes the symlink again

Administration
TODO

Troubleshooting Notes
LuCI Technical Reference Back to top 3 of 4 05/11/2011 12:27 AM

LuCI Essentials - OpenWrt Wiki

http://wiki.openwrt.org/doc/howto/luci.essentials

doc/howto/luci.essentials.txt Last modified: 2011/03/27 08:57 by orca

4 of 4

05/11/2011 12:27 AM