OpenEFA v1.5.6 Now Available - Critical Bug Fixes & Template Restoration

[adrastosefa]

We're releasing OpenEFA v1.5.6, a critical bug fix update that resolves
template regressions, permission errors, and UI issues introduced in v1.5.4.
All users on v1.5.4 or v1.5.5 should upgrade immediately.

-------------------------------------------------------------------------------
WHAT'S FIXED
-------------------------------------------------------------------------------

BACKUP MANAGEMENT RESTORED

Auto-Download Functionality
* Desktop downloads restored - Backups now automatically download to your
desktop after creation (previously broken in v1.5.4)
* Backup option checkboxes restored - Email attachments, config files, and
web application selection
* Clear button labels - "Download Database Backup" and "Download Full System
Backup" labels restored
* One-click convenience - Create backup and get immediate download without
manual navigation

CONFIGURATION PERMISSION ERRORS FIXED

Full System Backup Works Again
* Permission errors resolved - Fixed "Permission denied: module_config.json"
errors preventing backups
* Automatic permission correction - New fix_config_permissions() function
ensures all config files have correct ownership
* Comprehensive coverage - All JSON configs, .my.cnf, modules.ini properly
owned by spacy-filter user
* Installer integration - Fresh installations automatically set correct
permissions

USER MANAGEMENT FIXED

Edit User Form Now Works
* Form submission restored - "Update User" button now activates correctly
* Hidden field bug fixed - Removed problematic 'required' attribute from
hidden alias email field
* Full functionality - Can now update user names, company, roles, and domain
assignments
* HTML5 validation - Proper validation without blocking legitimate form
submissions

-------------------------------------------------------------------------------
CLEANUP & UI IMPROVEMENTS
-------------------------------------------------------------------------------

Removed Broken Elements
* Authentication card removed - Eliminated non-functional "Authentication"
card from config dashboard (route was never implemented)
* No functionality lost - authentication_config.json still exists and works;
system admins can edit JSON directly
* Cleaner interface - No more 404 errors from broken links

Template Synchronization
* 5 templates restored to working versions:
- backup_management.html (19,580 bytes with auto-download)
- base.html (updated to latest)
- email_detail.html (updated to latest)
- emails.html (updated to latest)
- quarantine_detail.html (updated to latest)

-------------------------------------------------------------------------------
ENHANCED UPDATE SYSTEM
-------------------------------------------------------------------------------

Smart Bootstrap Script
* One command for everything - install.openefa.com/install.sh works for both
fresh installs and updates
* Automatic detection - Recognizes existing installations and offers Update/
Reinstall/Cancel menu
* Version awareness - Shows current version before prompting
* Intelligent redirects - install.sh, update.sh, and bootstrap.sh all point
to the same smart script

-------------------------------------------------------------------------------
KNOWN ISSUES & WORKAROUNDS
-------------------------------------------------------------------------------

System Settings Table (v1.5.4 Upgrades Only)
* Fresh installs: No issue, table created automatically
* Upgrades from v1.5.3: May need manual table creation
* Symptom: "Table 'spacy_email_db.system_settings' doesn't exist"
* Workaround: SQL script provided in CHANGES_v1.5.6.md
* Future: Migration system planned for future releases

-------------------------------------------------------------------------------
INSTALLATION & UPGRADE
-------------------------------------------------------------------------------

FRESH INSTALLATION:

curl -sSL https://install.openefa.com/install.sh | sudo bash

UPGRADING FROM v1.5.4 or v1.5.5:

It's this easy:

curl -sSL https://install.openefa.com/update.sh | sudo bash

Or if you prefer the persistent script:

sudo /opt/spacyserver/tools/update.sh

The smart update script will:
1. Detect your current version (1.5.4 or 1.5.5)
2. Download v1.5.6 from GitHub
3. Create automatic backup before updating
4. Deploy all bug fixes and restored templates
5. Fix config file permissions automatically
6. Restart services automatically
7. Provide rollback option if needed

No downtime. No manual fixes. Just run it!

-------------------------------------------------------------------------------
WHAT'S UNDER THE HOOD
-------------------------------------------------------------------------------

Files Modified (v1.5.6):
* NEW: bootstrap.sh (intelligent install/update detection, 146 lines)
* UPDATED: VERSION (1.5.4 → 1.5.6)
* UPDATED: lib/services.sh (added fix_config_permissions function)
* UPDATED: openefa-files/web/templates/backup_management.html (restored
auto-download, 19,580 bytes)
* UPDATED: openefa-files/web/templates/config_dashboard.html (removed
Authentication card)
* UPDATED: openefa-files/web/templates/admin/edit_user.html (removed
required from hidden field)
* SYNCED: base.html, email_detail.html, emails.html, quarantine_detail.html

All v1.5.4 features intact:
* HTML Attachment Analyzer still working
* GeoIP2 geographic blocking still available
* Release restrictions still enforced
* System information page still accessible
* Dashboard improvements still active

-------------------------------------------------------------------------------
TESTING & VALIDATION
-------------------------------------------------------------------------------

This release has been extensively tested on:
* Production: 192.168.50.58 (openspacy) - v1.5.4 → v1.5.6
* Development: 192.168.50.66 (ubtemplate) - Multiple upgrade paths tested
* Fresh install validation
* Upgrade path validation (1.5.3 → 1.5.6, 1.5.4 → 1.5.6, 1.5.5 → 1.5.6)
* External downloads: 7 unique IPs downloaded v1.5.4/v1.5.5 on Oct 19

User Testing Results:
✓ User edit form submission - "That worked." - Confirmed functional
✓ Bootstrap script - "That is perfect." - Update detection working
✓ Backup auto-download - Tested and confirmed working
✓ Config permissions - Full backups complete without errors

-------------------------------------------------------------------------------
CRITICAL FIXES SUMMARY
-------------------------------------------------------------------------------

If you experienced any of these on v1.5.4 or v1.5.5:
✓ "Permission denied: module_config.json" - FIXED
✓ Backup downloads don't work - FIXED
✓ Can't update user information - FIXED
✓ "Table system_settings doesn't exist" - WORKAROUND PROVIDED
✓ Config dashboard Authentication card 404 - REMOVED

-------------------------------------------------------------------------------
DOCUMENTATION
-------------------------------------------------------------------------------

* Installation Guide:
https://github.com/openefaadmin/openefa ... LLATION.md

* System Management:
https://github.com/openefaadmin/openefa ... /README.md

* Release Notes:
https://github.com/openefaadmin/openefa ... _v1.5.6.md

-------------------------------------------------------------------------------
WHAT'S NEXT?
-------------------------------------------------------------------------------

Now that v1.5.6 has stabilized the platform:
* Migration system for database schema changes
* Template version tracking to prevent future regressions
* Additional phishing detection enhancements
* Performance optimizations
* Community-requested features

-------------------------------------------------------------------------------
GET INVOLVED
-------------------------------------------------------------------------------

* Forum: https://forum.openefa.com
* GitHub: https://github.com/openefaadmin/openefa-installer
* Documentation: https://docs.openefa.com

Found a bug? Report it on our GitHub Issues page.
Have a feature request? Start a discussion on our forum!

-------------------------------------------------------------------------------
BOTTOM LINE
-------------------------------------------------------------------------------

OpenEFA v1.5.6 fixes critical regressions and restores full functionality.

*** If you're on v1.5.4 or v1.5.5, upgrade today! ***

-------------------------------------------------------------------------------

OpenEFA - Modern Email Security for the Open Source Community

Posted: October 20, 2025
Version: 1.5.6
Priority: HIGH - All v1.5.4 and v1.5.5 users should upgrade immediately
License: GPL-3.0