PrestaShop and Module Updates
PrestaShop updates through official AutoUpgrade module — the only supported tool for major transitions (1.6→1.7, 1.7→8.x). Direct file copying without AutoUpgrade breaks database configuration.
Pre-update checks
# PrestaShop version
cat /var/www/shop.com/app/AppKernel.php | grep version
# or
php -r "define('_PS_ROOT_DIR_', '/var/www/shop.com'); require _PS_ROOT_DIR_.'/config/config.inc.php'; echo _PS_VERSION_;"
# Check PHP compatibility
# PrestaShop 8.x requires PHP 8.1+
php -v
Backup
# Database
mysqldump -u root -p prestashop_db | gzip > /backups/ps_db_$(date +%Y%m%d).sql.gz
# Files (including overrides and custom themes)
tar --exclude='./var/cache' --exclude='./var/logs' \
-czf /backups/ps_files_$(date +%Y%m%d).tar.gz -C /var/www/shop.com .
AutoUpgrade Installation and Run
# Install autoupgrade module
cd /var/www/shop.com
wget https://github.com/PrestaShop/autoupgrade/releases/latest/download/autoupgrade.zip
unzip autoupgrade.zip -d modules/autoupgrade
# Install via Admin: Modules → Upload a module → autoupgrade.zip
# or via CLI
php bin/console prestashop:module install autoupgrade
In Admin: Modules → Module Manager → 1-Click Upgrade. Before running:
- Disable custom modules that might conflict
- Put store in maintenance mode
- Ensure backup is complete
# CLI update (PrestaShop 1.7.8+)
php modules/autoupgrade/bin/autoupgrade check \
--admin-dir=admin_secret
php modules/autoupgrade/bin/autoupgrade update \
--admin-dir=admin_secret \
--channel=stable
Module Updates
# Via Admin: Modules → Module Manager → Update all
# CLI via PrestaShop API
php bin/console prestashop:module upgrade module-name
# Check module compatibility with PS version
# In module manifest.xml or composer.json:
# "prestashop/prestashop": ">=8.0"
Modules from official Marketplace update via Addons → My modules. Third-party modules — via FTP/Composer.
Cache clear after update
php bin/console cache:clear
# or via Admin: Advanced Parameters → Performance → Clear cache
# Regenerate .htaccess
php bin/console prestashop:generate:htaccess
Timeline
PrestaShop update within same major version (e.g., 1.7.8.x → 1.7.9.x) — hours. Transition between major versions (1.7 → 8.x) with theme and module compatibility check — 1–3 days.