Yeraze/meshmonitor v2.0.0-alpha4

v2.0.0-alpha4 - Session Store Fix (Final Docker Build Fix)

on GitHub

🔐 v2.0.0-alpha4 - Session Store Fix

⚠️ ALPHA RELEASE - For Testing Only

This is the fourth alpha release of MeshMonitor v2.0.0, finally resolving all Docker build issues by fixing the session storage dependency.

🐛 Critical Fix

Session Store Replacement (#142)

• Fixed: Docker builds failing due to sqlite3 native module in session storage
• Root Cause: connect-sqlite3 depends on sqlite3 (not better-sqlite3), causing ARM compilation failures
• Solution: Replaced with better-sqlite3-session-store which uses better-sqlite3
• Impact: Docker images now build successfully on ALL platforms

📝 Changes Since Alpha 3

- Removed: connect-sqlite3 (depended on sqlite3)
+ Added: better-sqlite3-session-store (uses better-sqlite3)
+ Added: TypeScript type definitions for better-sqlite3-session-store
+ Result: No more native module compilation issues

🔍 Technical Details

The Complete Docker Build Journey:

Alpha 1: ❌ npm ci --only=production failed (no package-lock.json)
Alpha 2: ❌ npm install --omit=dev failed (sqlite3 compilation on ARM)
Alpha 3: ❌ Copied node_modules but sqlite3 still failed to compile in builder
Alpha 4: ✅ Replaced session store - no sqlite3 dependency at all!

Why This Finally Works:

1. We use better-sqlite3 for our main database
2. connect-sqlite3 session store required sqlite3 (different package)
3. sqlite3 is a native module requiring compilation
4. ARM platforms lack build tools in Alpine images
5. better-sqlite3-session-store uses our existing better-sqlite3
6. No additional native modules = no compilation issues

✅ Verified

• ✅ All 505 tests passing locally
• ✅ Local Docker build successful
• ✅ Container runs correctly
• ✅ Multi-platform support (amd64, arm64, arm/v7)

🎯 Session Storage Improvements

Before (connect-sqlite3):

• Used separate sqlite3 package
• Required native compilation
• Failed on ARM platforms
• Manual session cleanup

After (better-sqlite3-session-store):

• Uses existing better-sqlite3
• No compilation needed
• Works on all platforms
• Auto-cleanup every 15 minutes

🔧 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.)
• ✅ Session storage functionality
• 🔍 Auto-announce scheduling (diagnostics in Alpha 2)

🐛 Known Issues

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

📦 What's Next

• ✅ Docker builds are now fully working!
• Continue investigating auto-announce scheduling
• Additional bug fixes from community feedback
• v2.0.0-beta1 with stabilized features

🔗 Full Changelog

Alpha 4 changes:

• fix: replace connect-sqlite3 with better-sqlite3-session-store (#142)

Previous alpha releases:

• v2.0.0-alpha3 - Multi-arch build attempt
• v2.0.0-alpha2 - Auto-announce debugging
• v2.0.0-alpha1 - Initial release

🎉 For All Users (Especially ARM/Raspberry Pi!)

This release marks the final resolution of the Docker build issues. You should now be able to:

1. ✅ Pull the Docker image from GitHub Container Registry
2. ✅ Build the image locally on any platform
3. ✅ Run MeshMonitor on Raspberry Pi without issues
4. ✅ Use all authentication and session features
5. ✅ Rely on automatic session cleanup

🙏 Acknowledgments

Thanks for the patience through multiple alpha releases while we tracked down all the Docker build issues!

🤖 Generated with Claude Code

🚀 MeshMonitor v2.0.0-alpha4

📦 Installation

Docker (recommended):

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

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