Yeraze/meshmonitor 2.0.0-alpha6

v2.0.0-alpha6 - Database-Backed Settings & Container Restart

on GitHub

Alpha 6 Release

New Features

Database-Backed Automation Settings

• Migrated all automation settings from browser localStorage to database
• Settings now persist server-side and are consistent across all browsers/devices
• No more per-browser configuration needed
• Settings survive browser data clearing

Container Restart/Shutdown Button

• Added intelligent restart/shutdown button to Settings page Danger Zone
• Automatically detects Docker vs NPM environment
• Shows "🔄 Restart Container" in Docker or "🛑 Shutdown" in NPM
• Implements graceful shutdown to prevent database corruption

Bug Fixes

• Fixed login issues in 2.0.0-alpha5 where admin couldn't login on fresh installs
• Fixed device favorites not being prepopulated from Meshtastic node data
• Fixed catch-all middleware blocking API routes

Technical Improvements

• Implemented graceful shutdown sequence (HTTP server → Meshtastic → Database)
• Added 10-second timeout to prevent hanging shutdowns
• Error handling for each component during shutdown
• Comprehensive test coverage for restart functionality (8 new tests)

Breaking Changes

• Automation settings (Auto-Acknowledge, Auto-Announce) no longer use browser localStorage
• Existing localStorage settings will not be migrated automatically
• Fresh install required or manual reconfiguration needed

This is a pre-release for testing. For production use, please use version 1.18.2.

🤖 Generated with Claude Code

🚀 Installation

Docker (recommended):

docker run -d \
  --name meshmonitor \
  -p 3001:3001 \
  -v meshmonitor-data:/data \
  -e MESHTASTIC_NODE_IP=192.168.1.100 \
  -e MESHTASTIC_TCP_PORT=4403 \
  ghcr.io/yeraze/meshmonitor:2.0.0-alpha6

Docker Compose:

services:
  meshmonitor:
    image: ghcr.io/yeraze/meshmonitor:2.0.0-alpha6
    container_name: meshmonitor
    ports:
      - "3001:3001"
    volumes:
      - meshmonitor-data:/data
    environment:
      - MESHTASTIC_NODE_IP=192.168.1.100
      - MESHTASTIC_TCP_PORT=4403
      - BASE_URL=  # Optional: e.g., /meshmonitor for reverse proxy
    restart: unless-stopped

volumes:
  meshmonitor-data:

📝 First-Time Setup

1. Access the web interface at http://your-server:3001
2. Login with default credentials:
   • Username: admin
   • Password: changeme
3. Important: Change the admin password immediately in Settings
4. Configure automation features in the Settings page if desired

⚙️ New in Alpha 6

Restart Container Button

Navigate to Settings → Danger Zone to find the new restart/shutdown button. This is useful for:

• Applying automation setting changes that require restart
• Restarting after configuration updates
• Graceful shutdown when needed

Database-Backed Settings

All automation settings are now stored in the database:

• Auto-Acknowledge settings (enabled, regex pattern)
• Auto-Announce settings (enabled, interval, message, channel, on-start)

These settings will persist across:

• Container restarts
• Browser changes
• Different devices accessing the same instance

🐛 Known Issues

• Some database foreign key constraint errors in test logs (non-critical)
• Auto-announce may require container restart to take effect after enabling

📚 Documentation

• API Reference
• Authentication Guide
• Configuration Guide

🚀 MeshMonitor 2.0.0-alpha6

📦 Installation

Docker (recommended):

docker run -d \
  --name meshmonitor \
  -p 8080:3001 \
  -v meshmonitor-data:/data \
  ghcr.io/Yeraze/meshmonitor:2.0.0-alpha6

🧪 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.