Installing osCommerce v.4.0
Server Configuration and System
Requirements to Install osCommerce 4
This article describes the required web server configuration and system requirements to install
*** PHP ***
PHP 7.0 to 8.0 versions are supported by osCommerce 4.
NOTE: We recommend to use PHP 7.2 and higher.
Required PHP modules: curl, ftp, gd, intl, mbstring, mysql, opcache (optional),soap, xml, xmlrpc, xsl, zip
*** MySQL Server ***
MySQL version 5.6.31, 5.7, 8.0 or MariaDB 10+
*** Web Server ***
osCommerce 4 supports Apache 2.4 without extra configuration. osCommerce 4 also supports Nginx 1.x with additional configuration.
NOTES: If you are running osCommerce 4 on a Linux server with SELinux, configure it to permit osCommerce 4 activities. If you are not familiar with SELinux, we recommend you to disable it, as osCommerce 4 does not function if it is misconfigured.
*** Recommended PHP/MySQL Parameters ***
These settings are done in the PHP configuration file php.ini of the server on which you are installing osCommerce 4:
expose_php = Off
max_execution_time = 600
max_input_time = 600
max_input_vars = 10000
memory_limit = 256M
post_max_size = 64M
upload_max_filesize = 64M
max_file_uploads = 50
session.gc_probability = 1
session.gc_maxlifetime = 14400
open_basedir = Off
If you have ModSecurity installed on your Apache web server, you must either disable it or whitelist your osCommerce files (so they are exempt from all mod_security rules).
Also make sure that at least Apache modules headers and rewrite are enabled, and X-Frame-Options header is set as below:
Header set X-Frame-Options: "sameorigin"
We recommend to enable the following Apache modules: deflate, expires, headers, http2 (optional), rewrite, ssl
Disable MySQL Strict Mode on the Server. Open MySQL/MariaDB configuration file with root privileges and insert the line under the [mysqld] section (if there is no [mysqld] section, create it)
[mysqld]sql_mode = ""
Change owner for Web root folder recursively in accordance which user permissions PHP scripts are running with.
By default, www-data
Regarding the server settings see also the article Installing osCommerce 4 on Dedicated Server, Cloud Server or VPS with the sample settings.
Upload the installation onto the web server, and unpack it. Ensure you have at least 800 Mb free space. Then open the web server URL in the web browser.
After reviewing the license agreement click on the Accept and Start Installation button.
Make sure your website (Current column) meets the following server requirements (Recommended and Required columns) and click on Proceed button.
Fill in the required fields and click on Install Database button.
If the database is not empty the following error will show up. Check the box next to Delete data and continue installation option and click on Retry button.
Fill in the required fields and click on Update Database button.
Fill in the required fields and click on Create access to create the administrator account.
Pass the recaptcha and click on Complete Installation button.
The system will redirect you to the same front end.