Skip to content

BrainDeLook/meshmonitor-ha

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MeshMonitor — Home Assistant Add-on

🇷🇺 Русская версия

GitHub Release License

MeshMonitor Logo

Home Assistant Add-on for MeshMonitor — a powerful dashboard and Virtual Node Server for Meshtastic mesh networks.

Features

  • 📡 Connect to Meshtastic node via TCP or USB Serial
  • 🗺️ Live map with node positions
  • 📊 Network telemetry and statistics
  • 🔌 Virtual Node Server — allows multiple simultaneous connections from Meshtastic mobile apps on port 4404
  • 🏠 Full Home Assistant Ingress support (no extra ports needed for the dashboard)
  • 🔄 Persistent data across restarts

Installation

One-click install

Add Repository to Home Assistant

  1. Click the button above to add this repository to Home Assistant
  2. Go to Settings → Add-ons → Add-on Store
  3. Find MeshMonitor and click Install
  4. Configure the add-on (see Configuration below)
  5. Click Start

Manual install

  1. Go to Settings → Add-ons → Add-on Store
  2. Click the three dots (⋮) in the top right → Repositories
  3. Add: https://github.com/BrainDeLook/meshmonitor-ha
  4. Find MeshMonitor in the store and install it

Configuration

Option Description Default
connection_type Connection type: tcp or serial tcp
MESHTASTIC_NODE_IP IP address of your Meshtastic node (TCP mode) 192.168.1.231
MESHTASTIC_TCP_PORT TCP port of the node (TCP mode) 4403
MESHTASTIC_SERIAL_PORT Serial port path (Serial mode) /dev/ttyUSB0
SESSION_SECRET Secret key for session encryption
DISABLE_ANONYMOUS Require login to view dashboard false

Connecting via USB Serial

If your Meshtastic node is connected via USB, select serial as the connection type and specify the correct port. Supported devices:

  • /dev/ttyUSB0, /dev/ttyUSB1
  • /dev/ttyACM0, /dev/ttyACM1

Virtual Node Server

The add-on exposes port 4404 as a Virtual Node Server. This allows multiple Meshtastic mobile apps to connect simultaneously to your node — something the node itself doesn't support natively.

To connect your mobile app:

  1. Open Meshtastic app → Settings → Connect
  2. Choose TCP
  3. Enter your Home Assistant IP and port 4404

Credits

License

MIT

About

MeshMonitor Home Assistant Add-on

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors