Modules extend PrestaShop’s functionality but installation sometimes fails — file permissions, PHP compatibility, missing dependencies or marketplace issues. This guide covers the common install failures and the fixes on a SmartXHosting-hosted PrestaShop store.
Install paths — marketplace, zip upload, Composer • “Module unable to install” • PHP version / dependency errors • Permission errors • Hook conflicts with existing modules • Module update breaking • FAQ
Three ways to install a PrestaShop module:
modules/, activate via CLI bin/console prestashop:module install [module-name].Generic error message covering many causes. Investigate via:
var/logs/prod.log for Symfony exceptions during installPrestaShop 9 requires PHP 8.2+. Some older modules assume PHP 7.x features. Symptoms:
install() method crashesFix: check module’s changelog for PrestaShop 9 / PHP 8.2 compatibility. Upgrade the module or find an alternative.
PrestaShop writes to modules/ during install. If permissions are wrong:
chown -R www-data:www-data modules (adjust to your web-server user)find modules -type d -exec chmod 755 {} \;Two modules registering for the same hook can clash. Symptoms: theme breaks, admin page blank, storefront errors. Investigation:
An update through Module Manager can fail partway, leaving the module in a broken half-installed state. Fix:
modules/SmartXHosting can restore from backup if the update corrupted data.
PrestaShop hosting with module-install support
SmartXHosting support can debug failed module installs using server-side logs and PHP error traces that aren’t visible in the admin UI.
See PrestaShop plansQ: Module install progress bar stops at 50%.
A: PHP timeout. SmartXHosting PHP timeout is 300s by default. Very large modules (100MB+) may need higher. Open a ticket for temporary increase.
Q: Module installs but shows as “not installed” in admin.
A: Database registration failed. Symptoms: tables created but ps_module row missing. Manually insert the ps_module row or reinstall from scratch.
Q: Can I install PrestaShop 8 modules on 9?
A: Sometimes. Compatibility shims handle many cases. Test on staging first.
Q: How do I completely remove a module?
A: Module Manager › Uninstall (removes DB entries) › Delete (removes files). Some modules leave hook records — for deep cleanup, SmartXHosting can verify DB state.
Q: Is installing modules safe during trading hours?
A: Small modules, usually yes. Large modules or those that modify core pages, install during off-peak hours. Keep a backup ready to restore.
Q: How do I roll back a module update?
A: Not native. Restore the module’s previous version from backup, re-upload zip, install. For data regressions, restore database backup (SmartXHosting automatic daily backups).
Q: Can SmartXHosting vet a module before I install?
A: Yes — send the module zip and we’ll review for security, code quality and compatibility. Part of the standard support service.