Quick Start Guide

Install the Monitoring Agent on your OpenWrt system with:

# OpenWrt >= 25.12
apk update
apk install openwisp-monitoring

# OpenWrt <= 24.10
opkg update
opkg install openwisp-monitoring

Development Builds

If you need an unreleased feature or bug fix, try the development version from downloads.openwisp.io. It lists APK packages built in the last two years by our continuous integration. Before installing one, add the OpenWISP public key to the APK keyring:

cat > /etc/apk/keys/openwisp-monitoring.pem <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEYhhsie+759Mk34fJso4cDHVeLNeE
277qiiRySdHKYQNx8KV1RGd1ynm+5m+Z3RUl1BMYAAqi8Tip1+6q+DgEiQ==
-----END PUBLIC KEY-----
EOF

Then download the matching netjson-monitoring and openwisp-monitoring APK files and sha256.manifest from the latest build. Verify the APK checksums before installing them. apk verifies their signatures with the installed public key.

cd /tmp
sha256sum -c sha256.manifest
apk add /tmp/netjson-monitoring_*.apk /tmp/openwisp-monitoring_*.apk

Now you can start the agent:

/etc/init.d/openwisp-monitoring start

See also

• For troubleshooting and debugging, refer to Debugging.

• To learn more about the configuration options of the monitoring agent, refer to Settings.

• For instructions on how to compile the package, refer to Compiling the Monitoring Agent.

• Read about the complementary Config Agent.