MeshMonitor

Appearance

GitHub Stars

Docker Compose Configurator ​

MeshMonitor Docker Compose Configurator

Configure your MeshMonitor deployment by selecting your options below. This tool will generate a ready-to-use docker-compose.yml and .env file for your setup.

1. Connection Type

How is your Meshtastic node connected?

2. Connection Details

The IP address of your Meshtastic node

Default is 4403

3. Deployment Mode

How will you access MeshMonitor?

4. Port Configuration

Port to access MeshMonitor web interface

5. Security Settings

Port for Meshtastic mobile apps to connect (default: 4404)

6. Additional Settings

Your timezone (e.g., America/New_York, Europe/London, Asia/Tokyo) See list

7. Generated Configuration

docker-compose.yml

services:
  meshmonitor:
    image: ghcr.io/yeraze/meshmonitor:latest
    container_name: meshmonitor
    ports:
      - "8080:3001"
      - "4404:4404"
    restart: unless-stopped
    volumes:
      - meshmonitor-data:/data
    env_file: .env
    environment:
      - NODE_ENV=development
      - TZ=America/New_York
      - MESHTASTIC_NODE_IP=192.168.1.100
      - ALLOWED_ORIGINS=http://localhost:8080
      - ENABLE_VIRTUAL_NODE=true

volumes:
  meshmonitor-data:
    driver: local

.env

# MeshMonitor Configuration
# Generated by MeshMonitor Docker Compose Configurator

# Meshtastic Node Connection
MESHTASTIC_NODE_IP=192.168.1.100

# Virtual Node Configuration
ENABLE_VIRTUAL_NODE=true

Deployment Instructions

  1. Copy the docker-compose.yml content above and save it to a file named docker-compose.yml
  2. Copy the .env content above and save it to a file named .env in the same directory
  3. Run docker compose up -d to start MeshMonitor
  4. Access MeshMonitor at http://localhost:8080

Need Help? ​

If you encounter any issues with your configuration:

What's Next? ​

After deploying with the generated configuration:

  1. Configure your node: Make sure your Meshtastic device is properly configured
  2. Set up notifications: Configure push notifications for alerts
  3. Security: Review security best practices
  4. Backups: Set up automated backups
  5. Monitoring: Configure health checks and monitoring

Configuration Options Explained ​

Connection Types ​

  • TCP/Network: For devices with WiFi or Ethernet connectivity. This is the most straightforward option and provides the best performance.
  • Bluetooth (BLE): For devices that only have Bluetooth connectivity. Requires the BLE Bridge and a system with Bluetooth hardware.
  • USB/Serial: For devices connected via USB or serial port. Requires the Serial Bridge and the device to be physically connected to your server.

Deployment Modes ​

  • Development (HTTP): Best for local testing and home use. Simple HTTP access without SSL/TLS.
  • Production with Reverse Proxy: Recommended for production deployments. Uses HTTPS via a reverse proxy like nginx, Caddy, or Traefik.
  • Production without Reverse Proxy: Direct HTTP access in production. Not recommended due to lack of encryption.

Security Options ​

  • Virtual Node: When enabled, allows multiple Meshtastic mobile apps to connect to MeshMonitor simultaneously without overwhelming your physical node. Highly recommended.
  • Disable Anonymous Access: When enabled, users must authenticate before accessing MeshMonitor. Useful for deployments accessible from the internet.

Advanced Topics ​

For more complex deployments, check out these resources:

Last updated: