Web Server Environment
CS-Cart is developed to meet most server configurations, ranging from shared hosting accounts to dedicated servers.
There are two core requirements for your host to run CS-Cart:
PHP version 5.3.6, 5.4, 5.5, 5.6, or 7. CS-Cart supports SAPI mod_php, FPM, FastCGI. We recommend:
PHP 5.6 for CS-Cart/Multi-Vendor 4.3.1 - 4.3.6.
PHP 7.0 for CS-Cart/Multi-Vendor 4.3.6 - 4.5.2. Earlier versions don’t support PHP 7.
PHP 7.1 for CS-Cart/Multi-Vendor 4.6.1 and newer versions. In earlier versions errors occurred on PHP 7.1.
PHP 7.2 is supported starting with CS-Cart/Multi-Vendor 4.7.2.
PHP 7.3 is supported starting with CS-Cart/Multi-Vendor 4.11.1.
PHP 7.4 is supported starting with CS-Cart/Multi-Vendor 4.12.1.
We recommend not to move your store to PHP 5.6, if you used PHP 7.0 and newer versions. This could lead to users not being able to sign in.
MySQL version 4.1 or higher (MySQLi or pdo_mysql should be supported). CS-Cart also supports MariaDB 5.5 or higher, and PerconaServer 5.5 or higher.
We recommend a Unix-like operating system for your server, such as FreeBSD, Linux, or OS X. These systems are scalable, more secure, and offer better performance. Both 64-bit and 32-bit operating systems are supported, but we recommend 64-bit systems: they don’t limit the maximum amount of RAM to 4 gigabytes, among other advantages.
CS-Cart is compatible with almost every server that supports PHP and MySQL. However, we recommend Apache or Nginx as the most robust and stable servers for your web store.
Server Configuration Requirements
SELinux and AppArmor should be disabled (on Linux servers).
safe_mode PHP directive should be disabled.
file_uploads, allow_url_fopen PHP directives should be enabled.
The following PHP commands should be enabled:
The following PHP extensions should be installed (required extensions are marked with *):
MySQL support* Required for storing the data of your store in a database.
Network requests support* Required for proper functioning of several payment gateways (such as PayPal, Authorize Net, etc.) and real-time shipping services (FedEx, UPS, DHL), for sending e-mails via SMTP, and for upgrading your store.
Graphics library* Required for creating smaller versions (thumbnails) of product images. If you don’t have a graphics library, you won’t be able to upload images for products.
EXIF support* Required for making sure that the thumbnails generated from images shot in landscape mode will be rotated correctly.
JSON support* Required for proper functioning of CS-Cart and Multi-Vendor; even some aspects of core functionality rely on JSON.
XML support* Required for proper functioning of CS-Cart and Multi-Vendor; even some aspects of core functionality rely on XML.
SOAP support* Required for proper functioning of several real-time shipping services (for example, Temando).
Multibyte string support* Required for proper handling of multibyte strings (for example, strings that contain Cyrillic symbols).
Character type checking support* Required for proper checking whether a character or string falls into a certain character class according to the current locale.
GZIP archives support* Required for unpacking TAR and GZIP archives. Otherwise you won’t be able to install add-ons and themes from such archives.
ZIP archives support* Required for unpacking ZIP archives. Otherwise you won’t be able to upgrade your store and install add-ons and themes from such archives.
File information support* Required for proper detection of the file type.
Cryptography support* Required for proper functioning of several payment gateways (such as Servired and SagePay) and for interacting with third-party services (such as Facebook).
FTP support Required for setting correct file and directory permissions during the installation and upgrades of the store, and during the installation of add-ons and themes. An FTP server must be installed on your server.
Cache and session backend Required for storing cache and PHP sessions in a high-performance storage rather than on the disk.
Either Imagick or GD PHP extension must be installed. These extensions are used for image manipulation, such as creating thumbnails, applying watermarks, etc. We recommend Imagick, because it offers better performance and quality of the processed images. Using GD can lead to crashes due to the lack of memory when large product images are uploaded.
We strongly recommend using at least ImageMagick 6.9.3-10 or higher, as it includes a critical vulnerability fix. ImageMagick 7 is only supported starting with CS-Cart/Multi-Vendor 4.7.2.
GD is included in PHP, however PHP should be compiled with the
--with-gdflag. The official PHP documentation has detailed installation instructions for GD. Please make sure your GD configuration includes the FreeType font library.
If you use Apache as your web server:
mod_rewrite should be enabled (for SEO to work);
mod_headers should be enabled (for CORS and widget mode to work);
mod_ssl should be enabled (for SSL to work);
mod_security should be disabled; if you don’t want to disable it fully, configure it to work with CS-Cart as described in
the .htaccess file should allow the following directives:
If PHP was compiled with the Suhosin extension, then configure it in the php.ini file as follows:
suhosin.memory_limit = 0 suhosin.post.max_vars = 3000 suhosin.get.max_totalname_length = 3000 suhosin.session.encrypt = Off suhosin.session.cryptua = Off suhosin.cookie.cryptdocroot = Off suhosin.session.cryptdocroot = Off
Suhosin is a PHP extension intended for protection. However, it can cause various issues with CS-Cart/Multi-Vendor.
CS-Cart Architects Team Recommends This
- Use a virtual or dedicated private server instead of a shared hosting; this allows for smoother upgrades.
- Install and enable Openssl PHP extension to generate more secure session keys.
- Install Redis or APCu and set it as a CS-Cart cache backend.
- Install OPcache.
- Install the mod_deflate Apache mod.
Compatible Hosting Providers
As you can see, the requirements for the web server environment are quite typical. Thousands of hosting providers meet them. But if you can’t decide on the hosting for your web store, please consider a compatible hosting provider from our Compatible Hosting list.
Server Hardware Requirements
Requirements to server hardware depend on multiple factors. The more products, customers, and functionality your store has, the higher-performing server you’ll need.
Here’s an example of the server hardware sufficient for 50 visitors per hour:
|CPU||One core, 2.4 GHz|