Skip to main content

Requirements

This section describes the requirements for installing and using ClientXCMS.

SaaS Installation​

Using ClientXCMS in Software as a Service (SaaS) mode allows you to use the application directly within the ClientXCMS ecosystem, without having to manage technical aspects such as installation, hosting, or maintenance.

The requirements are as follows:

  • have an account on the ClientXCMS platform;
  • subscribe to an active plan.

Plans are available for order at the following address: https://clientxcms.com/pricing

Self-Hosted Installation​

ClientXCMS can also be installed self-hosted (on-premises), provided you have:

  • a database;
  • a compatible PHP version.

This option requires:

  • basic technical knowledge in system administration;
  • an active Community plan on the ClientXCMS platform.

The corresponding plans are available on the following page: https://clientxcms.com/pricing

Technical Requirements​

  • Operating System: Linux (Ubuntu 22.04+, Debian 11+, CentOS 8+) or Windows Server
  • Disk Space: minimum 25 GB required
  • RAM: minimum 2 GB (4 GB recommended)
CTXHosting

You can rent a preconfigured and optimized virtual machine for ClientXCMS. We recommend checking out our CTXHosting project.

PHP​

ClientXCMS requires PHP 8.3 or higher to run. PHP 8.4 is also fully supported and offers the latest improvements in performance, security, and compatibility.

VersionSupport StatusSecurity Fixes Until
PHP 8.3Stable (recommended)December 31, 2027
PHP 8.4ActiveDecember 31, 2028

To check currently supported and recommended PHP versions, please visit the official website: https://www.php.net/supported-versions.php

Checking the Installed PHP Version​

You can check the PHP version installed on your server using the following command:

php -v
End of Life for PHP 8.1

PHP 8.1 reached its end of life (EOL) in January 2026. This means it no longer receives security updates or official patches.

It is strongly advised to update your PHP environment to PHP 8.3 or higher to ensure the security and stability of your application.

PHP Extensions​

ClientXCMS requires several PHP extensions to function properly. Make sure the following extensions are installed and enabled on your server:

Essential Extensions:

Extensions required by ClientXCMS:

  • php-dom - DOM/XML document manipulation
  • php-gd - Image manipulation and generation (QR codes, captchas)
  • php-intl - Internationalization functions (ICU)
  • php-libxml - Base XML library
  • php-simplexml - Simplified XML data processing
  • php-zip - Archive compression and decompression

Standard Laravel extensions (included with php-common):

  • php-common (includes: ctype, fileinfo, json, tokenizer, filter)
  • php-curl - HTTP/HTTPS communication and external APIs
  • php-mbstring - Multi-byte string support (UTF-8)
  • php-bcmath - Arbitrary precision mathematical calculations
  • php-openssl - SSL/TLS encryption and certificates
  • php-pdo - Database access interface
  • php-pdo-mysql - MySQL/MariaDB driver for PDO
  • php-xml - Additional XML support

Recommended extensions:

  • php-fpm - FastCGI process manager (production)
  • php-opcache - Opcode cache for better performance

Checking Installed PHP Extensions​

You can display the list of currently enabled PHP extensions on your server using the following command:

php -m

Or check a specific extension:

php -m | grep -i "extension_name"
# Example: php -m | grep -i "curl"

For PHP 8.3 installation and its extensions, please refer to the detailed installation guide for your environment:

Database​

ClientXCMS requires a database to store your application information.

MariaDB 10.11+ is the recommended solution for ClientXCMS due to:

  • Optimal performance with Laravel queries
  • Full compatibility with the MySQL ecosystem
  • Stability and long-term support (LTS)
  • Open source without license restrictions

MySQL​

MySQL 8.0.38+ is also supported and offers excellent compatibility.

Other Supported Databases​

ClientXCMS can work with other Laravel-compatible DBMS:

  • PostgreSQL 15+ (robust alternative)
  • SQLite (for testing and development only)
Production Recommendation

For a production environment, we strongly recommend MariaDB for its proven performance and reliability.

Web Server​

ClientXCMS is compatible with most web servers. It is recommended to use Apache or Nginx or a Plesk hosting.

Docker​

You can also install ClientXCMS via Docker. To do this, you must have Docker and Docker Compose installed on your server. You can follow the Docker installation instructions here.