Yeraze/meshmonitor v2.17.2

v2.17.2 - Message Management & Documentation Enhancements

on GitHub

🎉 What's New in v2.17.2

🗑️ Message Deletion & Purge Capabilities (#552, #557)

Complete message management system with individual and bulk deletion options:

Individual Message Deletion

• 🗑️ Trash icon in message hover menu (alongside reply and emoji)
• Single-click deletion with confirmation dialog
• Permission-based access control

Bulk Operations - Danger Zone

• Channel Purge: Delete all messages from a specific channel
• Direct Message Purge: Delete all DMs with a specific node
• Confirmation dialogs for safety
• Real-time message count updates

Security & Permissions

• channels:write permission required for channel message operations
• messages:write permission required for direct message operations
• Admins can delete any messages
• All deletion operations logged to audit log with user, IP, and timestamp
• Proper authentication checks prevent anonymous deletions

Technical Implementation

• Three new REST API endpoints:
  • DELETE /api/messages/:id - Delete single message
  • DELETE /api/messages/channels/:channelId - Purge channel messages
  • DELETE /api/messages/direct-messages/:nodeNum - Purge DM conversation
• Optimistic UI updates for instant feedback
• Full test coverage with 50+ unit tests
• Updated API documentation

📚 Comprehensive Configuration Documentation (#559)

Significantly expanded configuration documentation with 17 previously undocumented environment variables:

New Documentation Sections

• Meshtastic Connection Variables: TCP port and timeout configuration
• Push Notification Variables: Complete VAPID setup and TTL configuration
• System Management Variables: Backup, restore, upgrade, and Apprise settings
• Enhanced OIDC/SSO: Scopes, auto-creation, and HTTP options
• Virtual Node Enhancements: Admin command controls

Key Variables Added

# Meshtastic Connection
MESHTASTIC_TCP_PORT=4403
MESHTASTIC_STALE_CONNECTION_TIMEOUT=30000

# Push Notifications
VAPID_PUBLIC_KEY=your-public-key
VAPID_PRIVATE_KEY=your-private-key
VAPID_SUBJECT=mailto:admin@example.com
PUSH_NOTIFICATION_TTL=3600

# System Management
DATA_DIR=/data
BACKUP_DIR=/data/backups
SYSTEM_BACKUP_DIR=/data/system-backups
RESTORE_FROM_BACKUP=/path/to/backup.tar.gz
AUTO_UPGRADE_ENABLED=false
APPRISE_CONFIG_DIR=/config/apprise
DUPLICATE_KEY_SCAN_INTERVAL_HOURS=24

# OIDC Enhancements
OIDC_SCOPES="openid profile email"
OIDC_AUTO_CREATE_USERS=true
OIDC_ALLOW_HTTP=false

# Virtual Node
VIRTUAL_NODE_ALLOW_ADMIN_COMMANDS=false

# Other
TZ=America/New_York

All variables now include descriptions, defaults, and valid ranges where applicable.

🔗 Pull Requests

• #557 - Add message deletion and purge capabilities (fixes #552)
• #559 - Bump version to 2.17.2 and update configuration documentation

📦 Installation

Docker

docker pull ghcr.io/yeraze/meshmonitor:v2.17.2

Helm

helm repo update
helm upgrade meshmonitor meshmonitor/meshmonitor --version 2.17.2

🔄 Upgrading from v2.17.1

No database migrations required. This is a minor feature release with full backward compatibility.

1. Pull the new image: docker pull ghcr.io/yeraze/meshmonitor:v2.17.2
2. Restart your container: docker compose up -d
3. Review the new environment variables in the documentation

📖 Documentation

• Configuration Guide
• Message Deletion API
• Permission Management

Full Changelog: v2.17.1...v2.17.2

🚀 MeshMonitor v2.17.2

📦 Installation

Docker (recommended):

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

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