EastMesh
ForkEastMesh firmware builds for MeshCore, with MQTT repeaters, WiFi companions, and simple release downloads for supported boards. Features an optional local HTTPS config panel on supported ESP32 targets, JWT auth using device identity, and battery reporting.
Fork of MeshCore (Reference)
- Maintainer
- xJARiD ↗
- Status
- Active
- Maturity
- Beta
- Lifecycle
- Active
- Latest version
- 2026.7.0
- Released
- 2026-07-19
- Runtime
- Arduino · C++
- Distribution
- Community
- Licensing
- Open source
- License
- MIT
Capabilities
Transports
- ✓ BLE
- ✓ USB serial
- ✓ Native TCP
- ✓ Wi-Fi AP
Operations
- ✕ Web flasher
- ✓ OTA updates
Networking
- ✓ Repeater
- ✕ Room server
- ✓ Observer
- ✓ MQTT
- ✕ KISS modem
Hardware
- ✓ GPS
- ✓ Display
- ✕ Sensors
- ✕ Low-power RX
Protocol
- ✓ MeshCore compatible
Node role
Features
- MQTT repeater builds
- WiFi companion builds
- Optional local HTTPS config panel (ESP32)
- JWT auth using device identity
- Battery reporting on supported targets
- Observer role support
Project signals
- GitHub stars
- 23
- Forks
- 8
- Watchers
- 2
- Open issues
- 1
- Contributors
- 179
- Release downloads
- 5,522
- Latest downloads
- 128
- Source available
- Yes
- Releases available
- Yes
- CI builds
- Yes
Releases
from GitHub · updated 2026-07-19v2026.7.0 # Latest 2 variants 17 days ago · 2026-07-19 04:09 UTC
MeshCore EastMesh Observer
EastMesh
observer-eastmeshfirmware for MeshCore boards with secure MQTT uplink and optional local web management, based on MeshCore firmwarev1.16.0plus upstream dev updates (as of 2026-07-09).This release syncs with upstream MeshCore dev — bringing power-off/deep-sleep improvements, SX1262 LDO support, hardware channel-activity detection, and board/platform fixes — realigns saved settings storage with upstream so future syncs can't shift or corrupt EastMesh settings, and restores EastMesh/MeshMapper broker TLS trust after a server-side certificate change.
What's Changed
- Merged upstream MeshCore dev updates including power-off/deep-sleep improvements, SX1262 LDO support, hardware channel-activity detection, radio gain fixes, and board/platform fixes.
- Realigned saved node settings to upstream byte offsets and moved EastMesh-specific fields behind a reserved gap so future upstream syncs no longer shift or corrupt them.
- Restored EastMesh and MeshMapper broker TLS trust after
mqtt2.eastmesh.aumoved from Let's Encrypt to a Google Trust Services certificate. - Bumped CI build and docs workflows to Python 3.13.
Breaking Changes
- The saved settings layout changed: devices upgrading from
2026.6.6or earlier may need EastMesh-specific settings (such as fan control and bridge peer) and recently added radio settings reconfigured after the update.
Notes
- If your observer stopped uplinking to
eastmesh-auormeshmapperwith TLS certificate errors, this release is the fix — update and the connection will recover on its own. - After updating, check your fan control, bridge peer, and recently added radio settings (see Breaking Changes) and re-set any that came back at defaults.
eastmesh-auremains the recommended MQTT endpoint oncemqtt.iatais configured;meshmapperandwaevare available as global second brokers.- Select brokers from the Primary and Secondary dropdowns in the web panel, or toggle them from the CLI (
set mqtt.eastmesh-au on,set mqtt.meshmapper on,set mqtt.waev on, etc.). A maximum of two brokers can be enabled at once. waev(mqtt.waev.app) uses a 1-hour auth token that the firmware refreshes automatically, so no extra configuration is needed. Set your Waev account email withset mqtt.email <email>so Waev can link the observer to your account.- MQTT status messages report cumulative
packets_sentandpackets_receivedalongside the existing radio stats; both counters reset on reboot. - LetsMesh EU/US are retired but still selectable for legacy use.
- Custom MQTT is available for private broker deployments and uses username/password auth only. For TCP custom MQTT, use the broker host and port as before. For WSS custom MQTT, set the host and port, select WSS transport, and the firmware connects using
wss://host:port/mqtt. - WSS uses TLS encryption and validates against the ESP-IDF x509 root CA bundle.
- For maximum heap headroom on busy observers, use the web panel for setup and troubleshooting, then disable it with
set web off. - Browsers may still require accepting the self-signed certificate warning on first HTTPS access.
flood.max.unscopeddefaults to64; lower it only if you want to limit how far unscoped flood traffic repeats.flood.max.advertcontrols the hop limit for flooded advert packets.
Documentation
xjarid.github.io/MeshCore-EastMesh
Flashing
Assets
.bin- standard update image-merged.bin- full ESP32 image for flashing after erase
v2026.6.6 # 2 variants 1 month ago · 2026-06-27 13:12 UTC
MeshCore EastMesh Observer
EastMesh
observer-eastmeshfirmware for MeshCore boards with secure MQTT uplink and optional local web management, based on MeshCore firmwarev1.16.0.This release adds packet counters to the MQTT status payload — each observer now reports cumulative
packets_sentandpackets_receivedtotals in itsstatusmessage — so brokers and dashboards such as Waev and MeshMapper can track per-node throughput.What's Changed
- Added
packets_sentandpackets_receivedcounters to the MQTTstatuspayloadstatsobject, reporting cumulative radio TX/RX packet totals to align with the Waev/MeshMapper status schema.
Breaking Changes
- None in this release.
Notes
eastmesh-auremains the recommended MQTT endpoint oncemqtt.iatais configured;meshmapperandwaevare available as global second brokers.- Select brokers from the Primary and Secondary dropdowns in the web panel, or toggle them from the CLI (
set mqtt.eastmesh-au on,set mqtt.meshmapper on,set mqtt.waev on, etc.). A maximum of two brokers can be enabled at once. waev(mqtt.waev.app) uses a 1-hour auth token that the firmware refreshes automatically, so no extra configuration is needed. Set your Waev account email withset mqtt.email <email>so Waev can link the observer to your account.- MQTT status messages now report cumulative
packets_sentandpackets_receivedalongside the existing radio stats; both counters reset on reboot. - LetsMesh EU/US are retired but still selectable for legacy use.
- Custom MQTT is available for private broker deployments and uses username/password auth only. For TCP custom MQTT, use the broker host and port as before. For WSS custom MQTT, set the host and port, select WSS transport, and the firmware connects using
wss://host:port/mqtt. - WSS uses TLS encryption and validates against the ESP-IDF x509 root CA bundle.
- For maximum heap headroom on busy observers, use the web panel for setup and troubleshooting, then disable it with
set web off. - Browsers may still require accepting the self-signed certificate warning on first HTTPS access.
flood.max.unscopeddefaults to64; lower it only if you want to limit how far unscoped flood traffic repeats.flood.max.advertcontrols the hop limit for flooded advert packets.
Documentation
xjarid.github.io/MeshCore-EastMesh
Flashing
Assets
.bin- standard update image-merged.bin- full ESP32 image for flashing after erase
- Added
v2026.6.5 # 2 variants 1 month ago · 2026-06-26 02:52 UTC
MeshCore EastMesh Observer
EastMesh
observer-eastmeshfirmware for MeshCore boards with secure MQTT uplink and optional local web management, based on MeshCore firmwarev1.16.0.This release adds the Waev curated broker as a selectable MQTT uplink — with automatic short-lived auth tokens to satisfy Waev's requirements — and widens the Custom MQTT settings panel in the web panel.
What's Changed
- Added the
waevcurated broker (wss://mqtt.waev.app:443/mqtt) using WSS, verified TLS, and MeshCore JWT authentication with the broker host as the token audience. - Added
get mqtt.waevandset mqtt.waev on|offto toggle the Waev broker, and added Waev to the Primary MQTT and Secondary MQTT dropdowns in the web panel. - Added per-broker JWT auth token lifetimes; Waev receives a 1-hour token to match its shorter maximum token lifetime, while the other brokers keep the existing lifetime.
- Fixed the web panel so the Custom MQTT settings panel spans the full width of the MQTT Servers card when Custom is selected.
- Updated the README and custom CLI guides for the Waev broker.
Breaking Changes
- None in this release.
If you are upgrading from before
2026.6.4, that release's changes still apply:get mqtt.statusswitched from per-broker fields top:/s:broker slots, and saved LetsMesh EU/US selections are cleared once on upgrade.Notes
eastmesh-auremains the recommended MQTT endpoint oncemqtt.iatais configured;meshmapperandwaevare available as global second brokers.- Select brokers from the Primary and Secondary dropdowns in the web panel, or toggle them from the CLI (
set mqtt.eastmesh-au on,set mqtt.meshmapper on,set mqtt.waev on, etc.). A maximum of two brokers can be enabled at once. waev(mqtt.waev.app) uses a 1-hour auth token that the firmware refreshes automatically, so no extra configuration is needed. Set your Waev account email withset mqtt.email <email>so Waev can link the observer to your account.- LetsMesh EU/US are retired but still selectable for legacy use.
- Custom MQTT is available for private broker deployments and uses username/password auth only. For TCP custom MQTT, use the broker host and port as before. For WSS custom MQTT, set the host and port, select WSS transport, and the firmware connects using
wss://host:port/mqtt. - WSS uses TLS encryption and validates against the ESP-IDF x509 root CA bundle.
- For maximum heap headroom on busy observers, use the web panel for setup and troubleshooting, then disable it with
set web off. - Browsers may still require accepting the self-signed certificate warning on first HTTPS access.
flood.max.unscopeddefaults to64; lower it only if you want to limit how far unscoped flood traffic repeats.flood.max.advertcontrols the hop limit for flooded advert packets.
Documentation
xjarid.github.io/MeshCore-EastMesh
Flashing
Assets
.bin- standard update image-merged.bin- full ESP32 image for flashing after erase
- Added the
Device compatibility (1)
| Device | MCU | Radio | Status | Notes |
|---|---|---|---|---|
| Heltec V4 | esp32-s3 | Semtech SX1262 | ✓ Supported |