Yeraze/meshmonitor v2.0.0-alpha3

v2.0.0-alpha3 - Docker Multi-Architecture Build Fix

on GitHub

🔐 v2.0.0-alpha3 - Docker Build Fix for ARM Platforms

⚠️ ALPHA RELEASE - For Testing Only

This is the third alpha release of MeshMonitor v2.0.0, fixing the Docker build issues for ARM platforms (Raspberry Pi, etc.).

🐛 Critical Fix

Docker Multi-Architecture Build (#141)

• Fixed: Docker builds failing on ARM platforms (linux/arm/v7, linux/arm64)
• Issue: Native Node.js modules (better-sqlite3, bcrypt) couldn't compile in production stage
• Solution: Copy pre-compiled node_modules from builder stage instead of reinstalling
• Impact: Docker images now build successfully for all platforms (amd64, arm64, arm/v7)

📝 Changes Since Alpha 2

- Removed: npm install step in production stage (was failing on ARM)
+ Added: Copy node_modules from builder stage (includes compiled native modules)
+ Result: Multi-architecture Docker builds now work

🏗️ Technical Details

Why This Failed Before:

1. Production stage tried to run npm install --omit=dev
2. This triggered compilation of native modules (better-sqlite3, bcrypt)
3. ARM platforms don't have build tools (gcc, make, python) in the Alpine image
4. Installation failed with gyp ERR! not ok

How It's Fixed Now:

1. Builder stage compiles all dependencies (including native modules)
2. Production stage copies the entire node_modules directory
3. No compilation needed in production stage
4. Works across all architectures

✅ Benefits

• ✅ Multi-platform support: Works on x86_64, ARM64, and ARM/v7
• ✅ Faster builds: No npm install in production stage
• ✅ More reliable: No platform-specific compilation issues
• ✅ Raspberry Pi ready: ARM builds now complete successfully

🔧 First-Run Setup

Same as previous alphas:

• Username: admin
• Password: changeme

⚠️ IMPORTANT: Change this password immediately after first login!

🔑 Configuration

Same environment variables as Alpha 1 - see full documentation in the Alpha 1 release notes.

🧪 Testing

This alpha release focuses on:

• ✅ Docker build process working on all platforms
• ✅ ARM platform support (Raspberry Pi, etc.)
• ✅ Native modules working correctly in production
• 🔍 Auto-announce scheduling (diagnostics added in Alpha 2)

🐛 Known Issues

• Auto-announce may not be triggering at the configured interval (debugging logs in Alpha 2 should help diagnose)

📦 What's Next

• Monitor Docker builds to ensure they complete successfully
• Continue investigating auto-announce scheduling based on diagnostic logs
• Additional bug fixes from community feedback
• v2.0.0-beta1 with stabilized features

🔗 Full Changelog

All changes in Alpha 3:

• fix: copy compiled node_modules from builder instead of reinstalling (#141)

Previous alpha releases:

• v2.0.0-alpha2 - Auto-announce debugging
• v2.0.0-alpha1 - Initial release

🎯 For Raspberry Pi Users

This release specifically addresses build issues that prevented deployment on Raspberry Pi and other ARM devices. You should now be able to:

1. Pull the Docker image from GitHub Container Registry
2. Run MeshMonitor on your Raspberry Pi without compilation issues
3. Use all features including authentication and database operations

🙏 Acknowledgments

Thanks for the patience while we worked through the multi-architecture Docker build issues!

🤖 Generated with Claude Code