OpenWISP configuration interface implemented as LuCI extensions
HTML Lua Makefile CSS Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.



LuCI extensions for the OpenWISP project.


The goal of this project is to provide a limited web interface for LEDE / 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 LEDE / 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-mbedtls
    • luci-openwisp-openssl
    • luci-openwisp-polarssl
    • luci-openwisp-cyassl

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 you need to compile the package yourself 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-mbedtls: depends luci-openwisp, libustream-mbedtls and px5g
  • luci-openwisp-openssl: depends luci-openwisp, libustream-openssl and px5g
  • luci-openwisp-cyassl: depends luci-openwisp, libustream-cyassl and px5g
  • luci-openwisp-polarssl: depends luci-openwisp, libustream-polarssl and px5g

Compiling luci-openwisp

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

git clone git:// lede
cd lede

# configure feeds
cp feeds.conf.default feeds.conf
echo "src-git luciopenwisp" >> feeds.conf
./scripts/feeds update -a
./scripts/feeds install -a
# any arch/target is fine because the packages are architecture indipendent
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:// lede
cd lede

# 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
make -j1 V=s






See OpenWISP Support Channels.