Installing osCommerce v.4.0

From osCommerce Wiki
Jump to navigation Jump to search
no subcategories

Server Configuration and System

Requirements to Install osCommerce 4


This article describes the required web server configuration and system requirements to install

osCommerce 4.


*** 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

Apache 2.4

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.

Image 325.png

Make sure your website (Current column) meets the following server requirements (Recommended and Required columns) and click on Proceed button.

Image 326.png

Fill in the required fields and click on Install Database button.

Image 327.png

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.

Image 328.png

Fill in the required fields and click on Update Database button.

Image 329.png

Fill in the required fields and click on Create access to create the administrator account.

Image 330.png

Pass the recaptcha and click on Complete Installation button.

Image 331.png

The system will redirect you to the same front end.

Image 332.png