Important: This upgrade requires a detailed manual process due to the MySQL 5.7 to MySQL 8.0 transition. Future Octeth upgrades will be much more straightforward after completing this upgrade.

</aside>

Why This Upgrade Requires Manual Steps

Database Engine Change: Octeth v5.6.0 requires MySQL 8.0 or higher.
Environment Configuration Update: Some environment files and service definitions have been updated.
Structural Improvements: This lays the foundation for easier upgrades in the future.

Step-by-Step Upgrade Instructions

1. Backup Your Octeth v5.5.5 Installation

cd /path/to/octeth
docker compose down
cd ..
tar -czvf octeth_backup_$(date +%Y%m%d).tar.gz octeth/

Note: Always back up both your files and your database before proceeding.

2. Download and Prepare Octeth v5.6.0 Package

Download oempro-rel-v5.6.0.zip.
Extract it into a separate directory, e.g., /path/to/octeth_v560/.

cd /path/to/
unzip oempro-rel-v5.6.0.zip -d octeth_v560/

3. Sync Files (Excluding Runtime and Config Files)

Create an exclude file octeth-upgrade-exclude-list.txt with the following contents:

echo "_dockerfiles/clickhouse/data/*
_dockerfiles/elasticsearch/data/*
_dockerfiles/inbound-smtp-server/config.json
_dockerfiles/letsencrypt/*
_dockerfiles/mysql/*
_dockerfiles/rabbitmq/data/*
_dockerfiles/redis/data/*
_dockerfiles/haproxy.cfg
_dockerfiles/*-prod
_dockerfiles/*-prod.*
_dockerfiles/*-staging
_dockerfiles/*-staging.*
k8s-cluster-prod/
k8s-cluster-staging/
data/attachments/*
data/eg_spool/*
data/email_templates/*
data/exports/*
data/imports/*
data/incoming_emails/*
data/logs/*
data/maintenance_cache/*
data/screenshots/*
data/tmp/*
data/config.inc.php
data/license.dat
system/storage/
.oempro_clickhouse_env
.oempro_mysql_env
.oempro_rabbitmq_env
.oempro_redis_env
.oempro_supervisor_env
docker-compose.yml
docker-compose-*.yml
system/.env
system/storage/framework/sessions/*
system/bootstrap/cache" > octeth-upgrade-exclude-list.txt

Then sync:

rsync -avz --exclude-from "octeth-upgrade-exclude-list.txt" ./octeth_v560/ ./octeth/