Getting started

What’s New

Roadmap

Octeth Training Program

Installation & Setup

Requirements

Architecture

Server Setup

Oempro Installation

Community Edition Install

SSL Certificates

Version Upgrade

Troubleshooting

Video Tutorials

Video Tutorials

Administration

Quick Walkthrough

Security

Sub Admin Accounts

Settings

Delivery Servers

Global Segments

Global Custom Fields

Bounce Processing

Spam Complaints

Suppression List

Plug-Ins

Delivery Report

User Management

Maintenance

Audience Management

Introduction

Subscriber Lists

Custom Fields

Segments

Subscribers

Webhooks

Website Event Tracking

Email Marketing

Introduction

Auto Responders

Email Campaigns

Sender Domain Man.

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

Link Proxy Add-On

Developers

Introduction

Single Sign On

API

Plug-In Development

Database

Advanced

Reverse Proxy

Cookbook

Help

Troubleshooting

Contact Us

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

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

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

Octeth Development Roadmap

On this page

• What’s New in v5.7.0
• Core System Updates
• New Features
• Journey Builder
• Google Postmaster Tools
• Campaign & Email Features
• API Enhancements
• Import & Data Management
• Multi-Account & User Management
• Enhancements
• Performance Improvements
• User Experience
• API & Integration
• Development Tools
• Bug Fixes
• Critical Fixes
• Database & Performance Fixes
• Email & Delivery Fixes
• Journey & Workflow Fixes
• Data Import & Subscriber Fixes
• UI/UX Fixes
• Configuration & Security Fixes
• Code Cleanup & Maintenance
• Testing Improvements
• Version Information
• Migration & Upgrade Notes
• Important Database Changes
• Upgrade Process
• Octeth Development Roadmap

Older versions

What’s New in v5.6.0

What’s New in v5.5.5

What’s New in v5.5.4

What’s New in v5.5.3

What’s New in v5.5.2

What’s New in v5.5.1

What’s New in v5.5.0

What’s New in v5.1.1

What’s New in v5.1.0

What’s New in v5.0.3

What’s New in v5.0.2

What’s New in v5.0.1