MeshMonitor v4.0.0-beta8
⚠️ Pre-release. Continues the 4.0 multi-source beta series. Please back up
/databefore upgrading.
Summary
Maintenance pre-release focused on upgrade-path hardening and small UX polish on the new 4.0 multi-source dashboard. A migration guard now tolerates legacy telemetry→nodes foreign keys from 3.x databases so the 4.0 upgrade no longer fails on older installs. New dashboard sources default to a 30-second heartbeat instead of the previous no-signal state, and relay-role placeholder traceroute hops now render as "Unknown" rather than blanks. Docs were refreshed for the multi-source release, LXC systemd unit Documentation URLs were corrected, and a handful of dependencies (uuid 14, maplibre-gl 5.23) plus GitHub Actions (checkout@v6, codeql-action@v4, upload-pages-artifact@v5, wait-on-check-action 1.7.0) were updated.
Bug Fixes
- fix(traceroute): preserve relay-role placeholder hops as "Unknown" (#2755)
- fix(migrations): tolerate legacy telemetry→nodes FK on 3.x → 4.0 upgrade (#2754)
- fix(dashboard): default new source heartbeat to 30s (#2752)
- fix(lxc): correct Documentation URLs in systemd units (#2751)
Documentation
- docs: refresh 4.0 docs for multi-source release (#2753)
Dependencies
- chore(deps): bump uuid from 13.0.0 to 14.0.0 (#2738)
- chore(deps): bump maplibre-gl from 5.22.0 to 5.23.0 (#2657)
- chore(deps): bump github/codeql-action from 3 to 4 (#2735)
- chore(deps): bump actions/checkout from 4 to 6 (#2734)
- chore(deps): bump actions/upload-pages-artifact from 4 to 5 (#2733)
- chore(deps): bump lewagon/wait-on-check-action from 1.6.1 to 1.7.0 (#2732)
Issues Resolved
- #2750 [BUG] Incorrect Documentation URL in meshmonitor.service unit file
Upgrade Notes
- No breaking changes vs. beta7.
uuidbumped to v14 — requires Node 20+. MeshMonitor's CI matrix already covers Node 20–25; no action required for containerized deployments.- If your 3.x database previously failed the 4.0 migration due to a legacy
telemetry → nodesforeign key, this release should allow the upgrade to proceed cleanly.
Full Changelog: v4.0.0-beta7...v4.0.0-beta8
🚀 MeshMonitor v4.0.0-beta8
📦 Installation
Docker (recommended):
docker run -d \
--name meshmonitor \
-p 8080:3001 \
-v meshmonitor-data:/data \
ghcr.io/Yeraze/meshmonitor:4.0.0-beta8🧪 Testing
✅ All tests passed
✅ TypeScript checks passed
✅ Docker images built for linux/amd64, linux/arm64, linux/arm/v7
📋 Changes
See commit history for detailed changes.