Skip to main content

Auto-Update System

The egg includes an intelligent auto-update system that keeps your installation current with the latest features and security updates.

How it works:

  • Automatic Version Checking: Uses the Tavuru API to check for new releases
  • Smart Differential Updates: Downloads only changed files, not the entire codebase
  • Selective Updates: Only updates core system files (modules, nginx, php configs)
  • User Data Protection: Never touches your www directory or user data
  • Self-Update Capability: Can safely update its own update mechanism

    Configuration:

    Variable Default Description
    AUTOUPDATE_STATUS 1 Enable (1) or disable (0) auto-update checks
    AUTOUPDATE_FORCE 1 Automatically apply updates (1) or just check (0)

    Update Behavior:

    Conservative Mode (Default)

  • AUTOUPDATE_STATUS=1AUTOUPDATE_FORCE=0
  • Checks for updates and shows availability
  • Shows version information and changelog
  • Updates must be manually approved

    Automatic Mode

  • AUTOUPDATE_STATUS=1AUTOUPDATE_FORCE=1
  • Automatically downloads and applies updates
  • Shows detailed progress during updates
  • Creates backups before applying changes

    Disabled Mode

    AUTOUPDATE_STATUS=0
    Skips all update operations
    Useful for production environments requiring manual updates

    Example Output:

    [AutoUpdate] Current version: v2.1.0
    [AutoUpdate] Latest version: v2.2.0
    [AutoUpdate] ⚠ Update available: v2.1.0 → v2.2.0
    [AutoUpdate] Update summary:
      • Total changes: 15
      • Files added: 3
      • Files modified: 8
      • Files removed: 2
    [AutoUpdate] ✓ Update completed successfully

    What Gets Updated:

    ✅ Module scripts (modules/)
    ✅ Nginx configurations (nginx/)
    ✅ PHP configurations (php/)
    ✅ Core scripts (start-modules.sh)
    ✅ Documentation (README.md, LICENSE)
    ❌ User content (www/ directory)
    ❌ User data (logs, uploads, databases)