OpenWISP configuration interface (OpenWRT LuCI customizations)
HTML Lua Makefile CSS Shell
Latest commit 45f9f6f Feb 15, 2017 @nemesisdesign nemesisdesign 0.1.1 release



LuCI (OpenWRT Web Interface) customizations for the OpenWISP project.


The goal of this project is to provide a limited web interface for OpenWRT so that users can configure only the bare minimum in order for their device to connect to the OpenWISP 2 Controller.

Use this web interface only if you have a similar use case, otherwise you should keep the default OpenWRT interface (luci-mod-admin-full).


  • login with a different username and password combination than the root SSH password

  • possibility to edit LAN settings

  • status page (inherited from luci-admin-full)

  • upgrade firmware page

  • reboot

  • logout

  • meta-packages for easier installation:
    • luci-openwisp
    • luci-openwisp-polarssl with HTTPs support
    • luci-openwisp-openssl with HTTPs support

Install precompiled packages

First run:

opkg update

Then install one of the latest builds:

opkg install <URL>

Where <URL> is the URL of the image that is suitable for your case.

For a list of the latest built images, take a look at

If the SoC or OpenWRT (or LEDE) version you are using is not available, you have to compile the package, (see Compiling luci-openwisp).

Configuration options

UCI configuration options must go in /etc/config/luci_openwisp.

  • username: username for the web interface, defaults to operator
  • password: encrypted password for the web interface, defaults password (encrypted)

Change web UI password

To change the default password for the web UI, use the openwisp-passwd script:

Changing password for luci-mod-openwisp, username: operator
New password:
Retype password:
luci-mod-openwisp password for user operator changed successfully


This repository contains 2 packages:

  1. luci-mod-openwisp: contains the custom password validator and limited menu interface
  2. luci-theme-openwisp: contains a few adjustments to the general luci theme

Additionally a few meta-packages are also present in the luci-openwisp directory. These meta-packages can be used in alternative to the commonly used luci or luci-ssl.

  • luci-openwisp: depends on uhttpd, uhttpd-mod-ubus, luci-mod-openwisp and luci-theme-openwisp
  • luci-openwisp-polarssl: depends luci-openwisp, libustream-polarssl and px5g
  • luci-openwisp-openssl: depends luci-openwisp, libustream-openssl and px5g

Compiling luci-openwisp

The following procedure illustrates how to compile the meta-package luci-openwisp:

git clone --depth 1
cd openwrt

# configure feeds
cp feeds.conf.default feeds.conf
echo "src-git luciopenwisp" >> feeds.conf
./scripts/feeds update -a
./scripts/feeds install -a
# replace with your desired arch target
echo "CONFIG_TARGET_$arch=y" > .config;
echo "CONFIG_PACKAGE_luci-openwisp=y" >> .config
make defconfig
make tools/install
make toolchain/install
make package/luci-openwisp/compile
make package/luci-openwisp/install

Alternatively, you can configure your build interactively with make menuconfig, in this case you will need to select one of the available luci-openwisp variants by going to Luci > 1. Collections:

git clone git:// --depth 1
cd openwrt

# configure feeds
cp feeds.conf.default feeds.conf
echo "src-git luciopenwisp" >> feeds.conf
./scripts/feeds update -a
./scripts/feeds install -a
make menuconfig
# go to Luci > 1. Collections and select one of the variants






Send questions to the OpenWISP Mailing List.