End of life for on-premise instances
At the end of March 2023, we cease on-premise hosting for Xentral instances. We encourage you to migrate your Xentral instance to our cloud - please do not hesitate to contact account@xentral.com for discussing and scheduling your cloud migration, or refer to our website or to our Community for more information.
Be aware that at the end of March 2023 we will stop any support services for on-premise hosted instances. There will be no further bug fixing or updates available. Likewise, we will not issue any further open source versions.
This articles describes the hardware and software requirements for hosting Xentral on premise and the required configuration on the server. It also describes the requirements you need to meet in order to receive support for your on-premise hosted Xentral instance. If you do not adhere to all of these requirements, Xentral might not run properly and we will not provide any support.
Tip
Xentral offers only cloud hosting for new customers and encourages our existing customers to migrate onto the Xentral cloud.
Minimum requirements for your server:
-
8 CPU cores
-
16 GB memory (RAM)
-
500 GB SSD hard disk space available
If you do not meet these requirements, this might cause performance issues with your Xentral instance.
To ensure that your Xentral instance can be set up and run properly, you need to meet the following software requirements.
Your server must have one of the following Linux distributions as operating system:
-
Ubuntu
-
64-bit
-
Version 18.04 or higher (
>=18.04)
-
-
Debian
-
64-bit
-
Version 10.3 or higher (
>=10.3)
-
Important
You must have SSH access to your operating system in order to set up the required cron jobs.
You need to install PHP-FPM and PHP-CLI on your web server with the following version, configuration, and extensions.
|
Version |
PHP 7.4 or higher ( |
|
Configuration |
Ensure that the following
|
|
Extensions |
The following PHP extensions are required, whereas "*" means that any version can be used and, e.g., ">=10.4" means that version 10.4 or higher is required:  |
We officially support only the following web server:
-
Nginx version 1.18 or higher (
>=1.18)
We officially support only the following database:
-
MySQL 5.7
Warning
We do not support MySQL 8.0.
While some other database systems might work, we do not ensure this and it will impact the support services we offer, see Support requirements
When you set up your Xentral system, make sure you adhere to the following configuration requirements.
The document root of the web server needs to point to the www folder of the Xentral repository.
server {
2 location / {
3 # ...
4 root /xentral/www
5 # ...
6 }
7}
The server needs a valid SSL certificate to enable communication with the Xentral system.
You can get free SSL certificates via Let's Encrypt.
Be aware that our support services for on-premise hosted Xentral systems are linked to special requirements.
Make sure you cross-check your actual system configuration against the latest hardware, software, and configuration requirements described in this article before you contact the Xentral support.
In case of any deviations, state them clearly in the very beginning of your support request.
Be aware that we might not be able to provide support for deviating systems and configurations.
Warning
In case you neglected to inform us about a deviating setup in the support ticket and this results in extra investigation efforts on our side, we may charge you with the investigation effort.
In order to be able to provide support, we need access to your Xentral system and the server hosting it.
You need to ensure the following:
-
You have set up a support user with admin privileges on your Xentral instance and make it available to the Xentral support team.
-
You have set up SSH access to your server with
sudopermissions and make it available to the Xentral support team.