Common installation errors

2025-11-27 00:20:46

Please first ensure the $domain and $subDir (subdirectory) configurations in Config.php are correct. Do not add extra slashes to either $domain or $subDir. Additionally, the $urlRandomSuffix configuration in Config.php is used on your-domain/install page—please confirm it is consistent.
 
Then verify that SucShop has write permissions for the following paths:
  • /contents: SucShop requires write permissions for all files and subfolders under this directory.
  • system/smarty/templates_c: This directory stores generated HTML templates (write permission is mandatory).

Error: 404 error when visiting your-domain/install page

If you don't configure the SSL of your domain, use http://your-domain/install not https://your-domain/install.

Or check the $domain and $subDir configuration in Config.php. If your SucShop was installed in the root directory of your domain, $subDir="" and no slash is needed.

Error: ...no options table...

Check the permission of /contents folder and the /contents/sucshop.db file. The permission should be 755.

Error: Fatal error: Uncaught --> Smarty: unable to write file /www/wwwroot/sucshop.word-x.com/system/smarty/templates_c/

Check the permission of /system/smarty/templates_c folder. Or /sessions, /contents/uploads folder. The permission should be 755.

Error：Fatal error: Uncaught PDOException: SQLSTATE[HY000]: General error: 14 unable to open database file...

Fatal error: Uncaught PDOException: SQLSTATE[HY000]: 
General error: 14 unable to open database file in /www/wwwroot/my-domain.word-x.com/vendor/catfan/medoo/src/Medoo.php:565 Stack trace: #0 /www/wwwroot/my-domain.word-x.com/vendor/catfan/medoo/src/Medoo.php(565): PDOStatement->execute() 
#1 /www/wwwroot/my-domain.word-x.com/api/core/Core.php(42): Medoo\Medoo->exec() 
#2 /www/wwwroot/my-domain.word-x.com/api/core/Settings.php(2): Core->__construct() 
#3 /www/wwwroot/my-domain.word-x.com/system/shared/PublicVariable.php(2): Settings->__construct() 
#4 /www/wwwroot/my-domain.word-x.com/system/pages/home.php(2): PublicVariable->loadAllOptions() 
#5 /www/wwwroot/my-domain.word-x.com/index.php(274): require_once('...') 
#6 {main} thrown in /www/wwwroot/my-domain.word-x.com/vendor/catfan/medoo/src/Medoo.php on line 565

This error occurred after I copied a SQLite-based SucShop site to another domain’s root directory and updated the $domain value in Config.php. The issue was resolved by resetting the permissions of the /contents folder and the /contents/sucshop.db file to755.

Error: ❌ Database error: SQLSTATE[HY000]: General error: 5 database is locked

This error happens when you use SQLite database to install SucShop. We have already fixed this problem by changing the logic of our code. Please update to the latest version of SucShop.