Skip to main content
Academy Community Sign in

System requirements for installation at web hosting providers

  • Updated

Table of contents 

This article discusses and describes all the system requirements that you must meet for installation with web hosting providers.

Note: The software usually tries to load the .ini files via the /etc/php directory. If this is not correct, alternative paths can be specified. Customization on the part of xentral is not possible. More information can be found here. 

Installation with web hosting providers

The following system requirements apply to the installation at web hosting providers:

  • Apache / Lighttpd web server
  • MYSQL database with optional PHPMyAdmin, from xentral version 20.1 is minimum requirement MySQL version 5.7
  • PHP version 7.3 from xentral version 21.1, from xentral version 20.1 is minimum requirement PHP version 7.2
  • PHP extensions → php-mbstring, php-soap, php-imap, php-xml, php-zip, PHP-GD, php-cli
  • PHP extension for MySQL → Requires mysqli with MySQL Native Driver Support (mysqlnd) and PDO support.
  • Ioncube version of 10.2 or higher is required
  • Ioncube (web server) for the PHP version used
  • Ioncube (CLI) for the used PHP version (with the rights of the web server)
  • Sufficient upload capacity of at least 25MB
  • Sufficient script runtime (PHP timeout) with 15 minutes
  • Memory per PHP process at least 256MB
  • Setup of a cronjob with interval of one minute

MySQL-Database-version

Minimum requirement from version 17.1 is MySQL 5.5. Starting with xentral version 20.1 MySQL 5.7 becomes minimum requirement for operation. The use of MySQL 8.0 is possible, but currently not recommended or supported, because it can lead to display problems (as of 06/2020).

MariaDB-version

Starting with xentral version 20.1, MariaDB 10.2 becomes a minimum requirement for operation. Depending on the system, it may also be recommended to use version 10.4.

PHP-version

Minimum requirement from version 21.1 is PHP 7.3. Starting with xentral version 20.1 PHP 7.2 became minimum requirement for operation.

Prerequisites for xentral on V-Servers or Root Servers

Root Privileges:

  • From version 21.3.x root-privileges (superadmin user) are necessary on the server

Minimum requirements for small businesses with about one to three employees are these:

  • Ubuntu or Debian-Linux as operating system
  • 2 CPU cores
  • 6GB RAM
  • 100GB hard disk capacity

Minimum requirements for medium-sized companies (approx. 3-10) employees:

  • Ubuntu or Debian Linux as operating system
  • 4 CPU cores
  • 8GB RAM
  • 200GB hard disk capacity

Minimum requirements for larger companies (e.g.):

  • Ubuntu or Debian Linux as operating system
  • 8 CPU cores
  • 16GB RAM
  • 500GB hard disk capacity

Installed PHP modules

Which PHP modules have been installed can be checked in the system log, under Administration > Settings > System > System log. The installed PHP modules can also be seen under the following URL call: Own_Domain.com/WWW/index.php?module=systemlog

Binary Zip-extension for command lines available

xentral usually reads the zip module from the following path: /usr/bin/zip. You can use the "whereis zip" command to trace where this module was installed.

A refresh within the system log checks the paths again, because only when the zip-extension (binary) is read out in the system log, the entry in the system health is also displayed after the process starter is run again.

Note: As of 08.03.2021, the command is not supported on Mittwald systems. 

For information about the PHP customization, see PHP and CLI customization.

Server Timeout settings

The following settings are necessary/useful for processes with increased load time. Here the server timeout time should be increased. Often the default time is 30 seconds. Examples for processes that could load longer than 30 seconds:

  • Recalculate traffic lights in the order overview for >500 orders
  • Calculate auto shipping for >200 orders
  • Start autoversand (in general, the process starter "autoversand_manual" should always be set up in xentral here (queue) → processes each job individually in the queue and prevents a server timeout in this way)
  • Batch processing that takes more loading time Settings on the server:
  • max_execution_time → set approx. to 60-1000 (guideline: 10 orders - 500 and more).
  • max_input_time → must always be set greater than/equal to "max_execution_time".

Note: The settings can be viewed in the system log (see above).

Document master

The requirements have changed for the document master in version 21.1.x. The document root directory of the web server serving xentral must point to the www folder. Configurations that have www as part of the domain can cause security issues and are no longer supported.

Version 22.1 and above

The following system requirements apply to the installation at web hosting providers for version 22.1 and above:

  • Nginx web server
  • MySQL version 5.7
  • PHP version 7.4 
  • PHP extensions → php-imap, PHP-GD, php-ldap, php-intl, mysqli with MySQL Native Driver Support (mysqlnd) and PDO support, php-soap, php-zip, php-cli, php-xml, php-mbstring
  • Ioncube version 10.4 
  • Ioncube (web server) for the PHP version used
  • Ioncube (CLI) for the used PHP version (with the rights of the web server)
  • Sufficient upload capacity of at least 25MB
  • Sufficient script runtime (PHP timeout) with 15 minutes
  • Memory per PHP process at least 256MB
  • Setup of a cronjob with interval of one minute: cronjobs/starter2.php

Related articles