Getting started

Roadmap

Octeth Training Program

Installation & Setup

Community Edition Install

SSL Certificates

Version Upgrade

Troubleshooting

Video Tutorials

Administration

Audience Management

Website Event Tracking

Email Marketing

Journeys (Automation)

Bounce Processing

Email Personalization

FBL Processing

Email Builder Integrations

Email Deliverability

Sender Domain Management

Plug-Ins & Add-Ons

AI Plug-In

RSS Plug-In

Bounce Catcher Add-On

Developers

API

Advanced

Help

What’s New in v5.7.0

This document represents a cumulative list of all user-facing changes in Octeth v5.7.0. For more information, see our user guide and API documentation.

Core System Updates

MySQL Performance Optimization - Comprehensive query optimization with strategic index hints for faster data retrieval
ClickHouse Optimization - Increased concurrent queries to 200 with system log TTL optimization and disk usage monitoring
Session Management Extended - Default session lifetime increased to 30 days to prevent premature logouts
UTF8MB4 Migration - Complete database charset update from utf8 to utf8mb4 for better character support
Docker Hub Integration - Consolidated Docker architecture for simplified deployment and management
Horizontally Scalable Send Engine - Enhanced send engine with health monitoring and scalability support
Redis Caching System - Implemented caching for subscriber counts, list counts, tags, and custom fields
Cache Invalidation - Automatic cache clearing on subscriber and list mutations
Custom MySQL Profiles - Support for custom MySQL configuration profiles
Phpdotenv Integration - Enhanced .env file parsing with support for special characters

New Features

Journey Builder

Journey Decision Nodes - Advanced conditional logic and branching with nested decision support
Send Email Actions - Complete email action implementation with template selection and sender configuration
Multiple Journey Triggers - EmailOpen, EmailLinkClick, CustomFieldValueChanged, JourneyCompleted, and Untag triggers
Multiple Journey Enrollments - Allow contacts to enroll in the same journey multiple times
Journey Statistics Screen - Comprehensive journey analytics and performance tracking dashboard
Journey Activity Tracking - Detailed execution tracking with 95% database load reduction
Journey Copy/Clone - Clone entire journeys with proper action ID handling
Node Cloning - Duplicate individual journey nodes within the builder
Drag-and-Drop Improvements - Enhanced drag-and-move functionality for better user experience

Google Postmaster Tools

Complete Integration - Full OAuth flow, data collection, and automated monitoring
Analytics Dashboard - Correlation analysis with encryption/spam charts and detailed metrics
Redis Caching - Performance optimization for Postmaster data retrieval
Security Enhancements - Secure OAuth handling and validation
Date Range Filtering - Enhanced charts with flexible date range selection

Campaign & Email Features

Automated Campaign Reports - Schedule campaign reports to be generated and delivered automatically
Auto-Resend Campaigns - Automated follow-up campaigns targeting non-openers
Enhanced Campaign Metrics - Improved campaign performance display and tracking
Email Template Preview - Preview templates without associating them with lists or campaigns
Email Cloning - Clone and resend functionality for existing emails
Custom Email Headers - Journey/Action merge tag support in email headers
Campaign ISP/Domain Reports - Normalized reporting table for optimized ISP and domain analytics

API Enhancements

API Versioning - New /api/v1/ endpoints with backward-compatible /api/legacy/ paths
Subscriber.Exists Endpoint - Lightweight subscriber existence checks with proper error handling
Subscriber.Get Enhancements - Optional flags for enhanced performance and reduced data transfer
Subscriber.Delete.All - Bulk subscriber deletion with optional tag deletion
Segments API Enhancement - includetotals parameter for controlling totals retrieval
List.Get Optimization - Skip statistics calculation by default to prevent timeouts
API Slow Query Logging - MySQL-style logging for API performance monitoring
Rate Limiting - Implemented rate limiting for Subscriber.Get endpoint

Import & Data Management

Drip Import Reliability - Enhanced with automatic retries, comprehensive logging, and limit handling
Tag Subscribers During Import - Bulk tagging capability during the import process
Import Error Handling - Failed import lines logged and downloadable from UI
CSV Import Row Counting - Improved accuracy matching parseCSVData behavior with email detection
Subscriber Tags Management - Complete tag management UI and controller implementation

Multi-Account & User Management

Multi-Account Login Switching - Seamless account switching with Gravatar avatar integration
User Categorization - Organize users into custom categories
User Limit Utilization - Statistics and notifications for user account limits
Password Generator - Enhanced security with built-in password generator in user forms

Enhancements

Performance Improvements

QueryBuilder Optimization - Skip subqueries for COUNT operations, remove unnecessary ORDER BY/LIMIT/OFFSET
EventLogger RabbitMQ - Profiling instrumentation and performance optimization
Multi-Account Manager - Skip operations during API calls for better performance
Database Query Hints - Strategic USE INDEX hints for critical queries
Journey Statistics Aggregation - 95% database load reduction through optimized aggregation
3-Phase Statistics Optimization - MySQL query optimization across statistics calculations
Information Schema Caching - Cache database structure queries for faster access

User Experience

Date Filter Flexibility - More flexible date pattern matching in segment builder
TODAY Keyword Support - Use TODAY keyword in date filters for dynamic queries
'is empty' and 'is not empty' Operators - New segment builder operators for null/empty checking
Email Template Name Filtering - Filter journey email actions by template name
'Any Email Action' Option - Journey filtering for any email action trigger
Relative Date Filtering - Enhanced segment builder with relative date support
Dashboard Updates - Recent campaigns display limited to 20 for better performance
Confirmation Dialogs - Added confirmation prompts when copying journey actions
Plugin Enable/Disable - Toggle switches instead of links for better UX
Clear Filter Button - Improved subscriber browse modal filter clearing
Campaign Date Display - Show absolute dates instead of relative dates for clarity

API & Integration

Admin Email Endpoint - New endpoint for retrieving admin email addresses
Preheader Text Support - Custom preheader text in email preview API
PowerMTA Log Parser - API endpoint for PowerMTA log file parsing
Domain List API - Admin endpoint for domain management
User Status API - New Users.status endpoint for user state retrieval
Sender Domain Options - Include tracking settings in sender domain configuration

Development Tools

Octeth CLI Tool - Comprehensive command-line management tool with commands for:

Backend process management (start, stop, status)
Docker operations (up, down, rebuild, status, stop, kill)
Log monitoring (tail, reset) with MySQL and container log support
Database migrations
Composer dependency management
Redis cache management (flush, stats)
ClickHouse operations
Health checks

Bug Fixes

Critical Fixes

MySQL Deadlock in eg_queue - Resolved deadlock in email tracking operations with lock order reversal
Email Gateway Stuck Issue - Fixed gateway getting stuck when all recipients are suppressed
Journey Worker Deadlock - Resolved deadlock issues in journey processing
Segment Query Builder - Fixed incorrect OR operator application in complex queries
Campaign Event Filtering - Fixed filtering for non-queued recipients in campaign events
API Authentication Failures - Comprehensive API auth tests and fixes for authentication issues

Database & Performance Fixes

Subscriber Bounce Query - USE INDEX hint to prevent MySQL query performance degradation
Missing Database Indexes - Added critical performance indexes across multiple tables
List.Get API Timeout - Database index hint optimization to prevent timeouts
Journey Statistics Aggregation - 95% reduction in database load for statistics queries
QueryBuilder Performance - Cached information_schema queries and optimized COUNT operations

Email & Delivery Fixes

Email Subject HTML Entities - Resolved double escaping in email subject lines
Auto-Resend Campaign Filter - Correctly targets non-openers only
Email Suppression List - Fixed deletion functionality in suppression list management
Suppression List Check - Added TO/CC/BCC validation in email gateway
UTM Parameters Preservation - Google Analytics parameters correctly preserved in link tracking
URL Fragment Duplication - Comprehensive fix for encoded URL fragments
Transfer Encoding - Set proper transfer encoding headers in email sending

Journey & Workflow Fixes

Journey Copy/Clone - Fixed "Unknown column ActionID" error when cloning journeys
Nested Decision Support - Support for complex nested decision structures
Decision Node Validation - Added validation for empty decision criteria
Journey Trigger Criteria - Properly handle array/object property values in triggers
Journey Email Sending - Improved API error handling when sending journey emails
Conversion Value Tracking - Fixed key mismatch and revenue calculation bugs

Data Import & Subscriber Fixes

Subscriber Search Timeout - Optimized search performance for large contact lists
Double Opt-In Status - Fixed imported contacts getting stuck in pending status
Subscriber Date Migration - Migrated subscriber date columns from DATE to DATETIME for accuracy
SMS Custom Field Mapping - Restored accidentally deleted SMS mapping controller
Subscriber Permission Checks - Updated permission checks across subscriber controller methods
ListID Validation - Prevent SQL errors from invalid table names in list operations

UI/UX Fixes

Toast UI Component - Moved loading indicator from header to controller for better placement
Admin Dropdown Menus - Removed padding override causing alignment issues
Campaign Date Display - Display absolute dates instead of relative dates for clarity
Session Message Handling - Fixed session message display in email delivery settings

Configuration & Security Fixes

EnvParser Phpdotenv - Robust .env file parsing with proper special character handling
File Permissions - Comprehensive file permission checks and fix command
Admin Password Hashing - Removed problematic double MD5 hashing
API Key Security - Mask API key in subscriber HTTP examples
Redis Error Handling - Consistent error format across Redis operations
ClickHouse .htaccess - Protected bin/ and scripts/ directories from web access

Code Cleanup & Maintenance

SMS Module Cleanup - Removed old unused SMS connector modules
Legacy SMS Tables - Removed unused database tables from legacy SMS system
Docker Commands - Fixed deprecated docker-compose syntax across all scripts
Documentation Restructure - Split monolithic CLAUDE.md into modular focused files
Database Naming Conventions - Standardized naming patterns across database schema
BaseCampaignEventsTest - Improved test reliability by removing interactive terminal checks
QueryBuilderTestTrait - Created shared testing functionality for query builder tests
Subscriber Deletion Logic - Refactored into dedicated class methods
API Version Validation - Implemented whitelist enforcement for API versions
Email Parsing - Enhanced error handling in email parsing controller
RabbitMQ Handler - Centralized connection handler for improved reliability
Config System - Implemented centralized configuration with missing parameters fix

Testing Improvements

Email Suppression Tests - Comprehensive unit test suite for email suppression functionality
Campaign Events Tests - Enhanced tests with progress display for long-running test suites
Personalization Tests - Comprehensive unit tests for email personalization features
Subscriber Delete Tests - Bulk deletion test suite with edge case coverage
Journey Tests - QueryBuilder tests for journey rule validation
Playwright Setup - Initial setup for end-to-end browser testing
PHPUnit Improvements - Enhanced test expectations and output formatting

Version Information

Release Version: v5.7.0 Release Date: December 1, 2025 Development Period: 7.5 months (March 30 - November 16, 2025) Total Commits: 585 Features Added: 62 Bugs Fixed: 91 Performance Enhancements: 23

Migration & Upgrade Notes

Important Database Changes

This release includes several database migrations that will run automatically during upgrade:

Journey statistics tables for enhanced analytics
Google Postmaster schema for deliverability monitoring
Subscriber date columns migrated from DATE to DATETIME
New indexes for performance optimization
UTF8MB4 charset migration for improved character support
Campaign ISP/Domain normalized reporting table

Upgrade Process

Backup your database and configuration files
Pull the latest code from your repository
Run ./cli/octeth.sh composer:install to update dependencies
Run ./cli/octeth.sh migrate to execute database migrations
Update Docker containers with docker-compose pull && docker-compose up -d
Clear Redis cache with ./cli/octeth.sh redis:cache:flush
Verify system health with ./cli/octeth.sh health:check

Note: No breaking changes in this release. All existing functionality remains compatible.

Octeth Development Roadmap

Version	Status	Release Date	Notes
v5.0.0	Released	Jan 3rd, 2022	5b138d5
↳ v5.0.1	Released	May 2nd, 2022	b6ea225
↳ v5.0.2	Released	Aug 17th, 2022	f8d417f
↳ v5.0.3	Released	Oct 3rd, 2022	3240487
v5.1.0	Released	Dec 26th, 2022	5b9a8c1
↳ v5.1.1	Released	Mar 14th, 2023	4a467c0
v5.5.0	Released	Apr 22nd, 2024	2862af5
↳ v5.5.1	Released	Jun 24th, 2024	5a89324
↳ v5.5.2	Released	Jul, 30th, 2024	d4b8106
↳ v5.5.3	Released	Aug, 16th, 2024	2d11177
↳ v5.5.4	Released	Aug, 23rd, 2024	34fd437
↳ v5.5.5	Released	Sep, 21st, 2024	95f665d
v5.6.0	Released	Mar 30th, 2025	188b432
v5.7.0	Released	Dec 1st, 2025	b57e2e1
↳ v5.7.1	Released	Dec 4th, 2025	00a7640
↳ v5.7.2	Released	Dec 29th, 2025	17af4d8
↳ v5.7.3	Released	Jan 3rd, 2025	bf57e1a
↳ v5.7.4	Collecting User Feedback	TBA - January 2025	n/a
v6.0.0	Under Development	2025 Q1 - TBA	n/a