Install mndw

Prerequisites

Install Entware (OPKG) on the router and make sure you have shell access to it. Follow the Entware installation guide; this guide covers installing mndw after Entware is ready. The feed is served over HTTPS, and Entware's default wget has no HTTPS support, so the command below installs wget-ssl and ca-bundle first.

Install

Run this command in the OPKG shell:

opkg update && opkg install wget-ssl ca-bundle && wget -qO- https://eralde.github.io/mndw-opkg-feed/add_repo.sh | sh

The script detects the router architecture (aarch64-3.10, mips-3.4, or mipsel-3.4), installs the feed's public key, adds the feed configuration if it is not there yet, runs opkg update, and installs the mndw package. The feed source is mndw-opkg-feed.

Open the dashboard

The installer prints the dashboard address. When port 1189 is free, it is typically http://<router>:1189. To find the selected port later, run:

cat /opt/var/lib/mndw/frontend-port

Sign in with the router account.

Upgrade

In the dashboard, open Settings → System update. From a terminal, update the package lists and upgrade mndw:

opkg update && opkg upgrade mndw

First-time installs use the wget command above. For an existing installation, run opkg update && opkg upgrade mndw.

Install your own plugin

From your plugins project, run npx mndw zip hello-widget on the plugin folder, then upload the ZIP through plugin management in the dashboard. A plugin with a backend must be approved before it can run; a plugin without a backend installs directly. See Validation and packaging for how to prepare the ZIP.

Troubleshooting

If automatic port detection selects the wrong listener, set MNDW_DEVICE_PORT=<port> in /opt/etc/mndw.conf.