🚀 MeshMonitor v2.15.0 - Automatic Self-Upgrade

⚠️ NEW FEATURE DISCLAIMER

This release introduces automatic self-upgrade functionality - a major new feature that allows one-click upgrades directly from the web UI. While thoroughly tested, this is a brand new capability. Please report any issues you encounter via GitHub Issues.

📋 Docker Compose Configuration Required

To use the auto-upgrade feature, you need to add the upgrade watchdog sidecar to your deployment. The easiest way to configure this is using our Docker Compose Configurator which generates the correct configuration automatically when you enable the "Auto-Upgrade" option.

✨ What's New

🎯 Automatic Self-Upgrade

Upgrade MeshMonitor to new versions with a single click directly from the web interface!

Key Features:

• One-Click Upgrades - "Upgrade Now" button appears when new versions are available
• Real-Time Progress - Live progress display (backup → download → restart → health check)
• Automatic Backups - Full data backup before every upgrade
• Pre-Flight Checks - Validates disk space, permissions, and system readiness
• Health Verification - Ensures new version starts correctly before completing
• Timeout Protection - Automatically recovers from stuck upgrades after 30 minutes
• Safe Container Recreation - Preserves all environment variables, volumes, ports, and network config

📖 Documentation

• Auto-Upgrade Guide - Complete setup and usage documentation
• Docker Compose Configurator - Generate correct Docker Compose configuration
• Troubleshooting Guide - Common issues and solutions

🔧 Setup Instructions

Option 1: Using the Configurator (Recommended)

1. Visit the Docker Compose Configurator
2. Configure your deployment settings
3. Enable the "Automatic Self-Upgrade" checkbox
4. Download the generated docker-compose.yml
5. Run: docker compose up -d

Option 2: Manual Configuration

Add the upgrade overlay to your existing deployment:

# Download the upgrade overlay file
curl -O https://raw.githubusercontent.com/Yeraze/meshmonitor/main/docker-compose.upgrade.yml

# Start with both compose files
docker compose -f docker-compose.yml -f docker-compose.upgrade.yml up -d

The upgrade watchdog script is automatically deployed to the data volume - no manual script download needed!

📦 How It Works

1. Automatic Update Detection - Checks GitHub for new releases every 4 hours
2. Update Notification - Banner appears in web UI when updates are available
3. One-Click Upgrade - Click "Upgrade Now" to start the process
4. Automated Process - Watchdog sidecar handles backup, image pull, container recreation, and health checks
5. Automatic Reload - Page reloads with new version when complete

🔒 Safety Features

• ✅ Pre-flight validation (disk space, permissions, backup directory)
• ✅ Automatic backup creation before upgrade
• ✅ Container configuration preservation (volumes, ports, env vars, networks)
• ✅ Health check verification after upgrade
• ✅ Automatic timeout and cleanup (30 minutes)
• ✅ Works with any Docker Compose configuration

📋 Requirements

• Docker with socket access (/var/run/docker.sock)
• Shared /data volume between main container and upgrader
• At least 500MB free disk space
• Docker Compose overlay configuration (use the Configurator)

🐛 Known Issues & Feedback

This is the first release with auto-upgrade functionality. If you encounter any issues:

1. Check the Troubleshooting Guide
2. Review the Auto-Upgrade Documentation
3. Report issues at GitHub Issues

Please include:

• Your deployment method (Docker Compose, standalone, etc.)
• Upgrade logs from docker logs meshmonitor-upgrader
• Application logs from docker logs meshmonitor

📝 Full Changelog

Features

• #482 - Add automatic self-upgrade functionality with watchdog sidecar
• #481 - Document auto-upgrade functionality completion
• #480 - Add automatic app updates on release push
• Upgrade watchdog script auto-deployment to shared volume
• Web configurator with auto-upgrade option
• REST API endpoints for upgrade management
• Upgrade history tracking in database
• Real-time progress monitoring

Documentation

• Complete auto-upgrade setup and usage guide
• Troubleshooting section with common issues
• Security considerations and best practices
• Docker Compose configurator integration

Infrastructure

• New upgrade_history database table
• /api/health endpoint for health checks
• Upgrade watchdog shell script with Docker commands
• Docker Compose overlay file for upgrade capability

🙏 Special Thanks

Thank you to everyone testing and providing feedback on this major new feature!

Full Commit History: v2.14.4...v2.15.0

🤖 Generated with Claude Code

🚀 MeshMonitor v2.15.0

📦 Installation

Docker (recommended):

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

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

🚀 MeshMonitor v2.15.0

📦 Installation

Docker (recommended):

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

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

🚀 MeshMonitor v2.15.0

📦 Installation

Docker (recommended):

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

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