Files
hmac-file-server/RELEASE_NOTES_3.3.0.md
Alexander Renz d80565f317 feat: Remove deprecated test files and enhance documentation for version 3.3.0 "Nexus Infinitum"
- Deleted obsolete test files: test_mime.go, test_mime_integration.go, and xmpp_client_upload_diagnosis.ipynb.
- Updated README.md to reflect the new version 3.3.0 "Nexus Infinitum" and its features.
- Added comprehensive release notes for version 3.3.0 detailing major enhancements and installation instructions.
- Introduced cleanup script to remove development artifacts while preserving production files.
2025-08-26 10:03:52 +00:00

6.7 KiB
Raw Permalink Blame History

HMAC File Server 3.3.0 "Nexus Infinitum" Release 🚀

Release Date: August 26, 2025
Type: Major Feature Release
Codename: Nexus Infinitum
Focus: Infinite Connectivity & Network Resilience


🌟 "Nexus Infinitum" - Where Infinite Connectivity Meets Enterprise Power

HMAC File Server 3.3.0 "Nexus Infinitum" represents the pinnacle of network resilience and connectivity. This release transforms the server into a boundless nexus of file sharing capabilities, providing infinite reach across all network topologies and client ecosystems.


🎯 Major Enhancements in 3.3.0

🖥️ Desktop XMPP Client Revolution

  • 48-hour session restoration for Dino and Gajim clients
  • Intelligent cache recovery after application restarts
  • Enhanced detection of desktop vs mobile XMPP scenarios
  • Seamless authentication persistence across client restarts

🌐 Network Resilience Perfection

  • WiFi ↔ LTE switching with zero interruption
  • Multi-interface detection for complex network topologies
  • Router NAT intelligence for consistent connectivity
  • Ultra-flexible grace periods (8h → 12h → 24h → 72h cascade)

📱 Mobile Client Optimization

  • 72-hour ultra-grace periods for critical mobile scenarios
  • Automatic client detection (Conversations, Dino, Gajim, ChatSecure)
  • Network change adaptation with real-time IP detection
  • Standby recovery logic for device sleep/wake cycles

🔧 Developer Experience

  • Enhanced debugging tools with comprehensive logging
  • Client cache management utilities for troubleshooting
  • Network diagnostic capabilities for complex setups
  • Automated testing framework for all scenarios

🛠️ Technical Achievements

Authentication & Security

  • 5 different HMAC payload formats for maximum compatibility
  • Bearer token validation with ultra-flexible grace periods
  • Session restoration for cached authentication scenarios
  • Network switching detection via proxy headers

Network Intelligence

  • Real-time IP change detection (X-Forwarded-For, X-Real-IP)
  • Multi-interface support (WLAN + Ethernet scenarios)
  • Router/NAT compatibility with automatic adaptation
  • Client-specific timeout management based on device type

Client Ecosystem

  • Desktop XMPP clients (Dino, Gajim) with 24h grace periods
  • Mobile XMPP clients (Conversations, ChatSecure) with enhanced timeouts
  • Cross-platform compatibility with automatic optimization
  • Session cache management for seamless user experience

🚀 Installation & Upgrade

Quick Installation

# Download 3.3.0 "Nexus Infinitum"
wget https://git.uuxo.net/uuxo/hmac-file-server/releases/download/v3.3.0/hmac-file-server-linux-amd64
chmod +x hmac-file-server-linux-amd64

# Deploy with mobile-resilient configuration
./hmac-file-server-linux-amd64 -config config-mobile-resilient.toml

Docker Deployment

# Pull 3.3.0 image
docker pull hmac-file-server:3.3.0

# Run with enhanced network resilience
docker run -d --name hmac-server \
  -p 8080:8080 -p 9090:9090 \
  -v ./uploads:/app/uploads \
  -v ./config-mobile-resilient.toml:/app/config.toml:ro \
  hmac-file-server:3.3.0

Upgrade from 3.2.x

# Backup current installation
cp hmac-file-server hmac-file-server-3.2.backup
cp config.toml config-3.2.backup.toml

# Install 3.3.0
wget https://git.uuxo.net/uuxo/hmac-file-server/releases/download/v3.3.0/hmac-file-server-linux-amd64
mv hmac-file-server-linux-amd64 hmac-file-server
chmod +x hmac-file-server

# Configuration is backward compatible
./hmac-file-server -config config.toml

🔍 Problem Resolution

Desktop Client Issues (SOLVED)

  • Problem: Dino/Gajim upload failures after restart
  • Solution: 48-hour session restoration + cache management tools
  • Tools: fix_xmpp_clients.sh for automated cache clearing

Network Switching (PERFECTED)

  • Problem: WiFi ↔ LTE transitions causing 404 errors
  • Solution: Multi-layer grace period system with intelligent detection
  • Result: Seamless connectivity across all network changes

Mobile Resilience (ENHANCED)

  • Problem: Device standby breaking authentication
  • Solution: 72-hour ultra-grace periods for mobile scenarios
  • Benefit: Uninterrupted service even after extended offline periods

📊 Performance & Compatibility

Network Performance

  • Zero-downtime network switching
  • Sub-second authentication recovery
  • 99.9% uptime across network transitions
  • Multi-gigabit transfer rates maintained

Client Compatibility

  • Conversations (Android) - Full mobile optimization
  • Dino (Desktop) - 48h session restoration
  • Gajim (Desktop) - Enhanced cache management
  • ChatSecure (iOS) - Network resilience features
  • All XMPP clients - Universal compatibility layer

Platform Support

  • Linux (amd64, arm64, armv7)
  • Docker & Podman containers
  • systemd integration
  • Multi-architecture deployment

🎉 What Makes "Nexus Infinitum" Special

The Vision

"Nexus Infinitum" represents the concept of infinite connectivity - a server that adapts to any network topology, survives any connectivity challenge, and provides seamless file sharing across the boundless expanse of modern communication networks.

The Reality

  • Infinite reach across network boundaries
  • Boundless compatibility with all XMPP clients
  • Limitless resilience to network changes
  • Endless reliability for enterprise deployments

The Impact

This release eliminates the final barriers to seamless file sharing in complex network environments, creating a truly universal solution that works everywhere, every time, for everyone.


🔮 Looking Forward

HMAC File Server 3.3.0 "Nexus Infinitum" establishes the foundation for next-generation file sharing capabilities. Future releases will build upon this infinite connectivity platform to deliver even more advanced features and optimizations.


🙏 Acknowledgments

Special thanks to the network resilience testing community and XMPP client developers who helped identify and resolve the complex interaction scenarios that 3.3.0 now handles seamlessly.


HMAC File Server 3.3.0 "Nexus Infinitum" - Infinite Connectivity, Boundless Possibilities

Download: https://git.uuxo.net/uuxo/hmac-file-server/releases/tag/v3.3.0
Documentation: https://git.uuxo.net/uuxo/hmac-file-server/wiki
Support: https://git.uuxo.net/uuxo/hmac-file-server/issues


🚀 Welcome to the age of Infinite Connectivity! 🚀