Download & Installation
2025-11-08 01:39:31
Environment
- PHP 7.0 or higher
- Database: MySQL 5.6+ (for MySQL users); SQLite is recommended for small-scale sites
- Minimum server requirements: almost any cheap hosting/server
- Web Server: Apache or Nginx
Step 1
Click to download the SucShop installation package (this is a free trial version, uses SQLite database by default, and has no e-commerce features). Unzip the file and upload it to your server’s root directory or a subdirectory—for example, the htdocs folder in Xampp, or the www folder on other servers.
Step 2
Modify the settings in the Config.php file in the root directory:
l $domain: Your website’s domain name.
l $subDir: Subdirectory (leave it blank if installing in the root directory).
l $urlRandomSuffix: Create a random mix of letters and numbers. It will be the suffix for your login page URL and the secret key for the installation page (so only you can install it).
l Database type: Choose SQLite or MySQL (note: this is case-sensitive).
l If using MySQL: Fill in $dbHost and $dbInfo with your database details. SQLite doesn’t need these.
Step 3
Visit the installation URL (http://your_domain/install, If your domain does not have SSL configured, please use HTTP instead of HTTPS.). You must configure Config.php first—otherwise, installation won’t work. On the installation page, enter your username, password, website email, and $urlRandomSuffix. Then select your default language.
For Nginx servers: You need to do some configurations. Paste the following code into your Nginx server's configuration file. With ChatGPT’s help, this should be easy for you.
server {
listen 80;
server_name example.com;
root /var/www/example.com;
index index.php index.html;
# Block access to sensitive files
location ~ /\.(git|svn|env|project|htaccess|user\.ini) {
deny all;
}
location ~* \.(gif|jpg|jpeg|png|bmp|swf)$ {
expires 30d;
}
location ~* \.(css|js)$ {
expires 12h;
}
# This is MUST!
location / {
try_files $uri $uri/ /index.php?$query_string;
}
}
Installation is done!
Important: After installation, delete the install folder in the SucShop root directory. This prevents others from messing with your website.
Video tutorial