Server side set up for hosting¶

System Requirements¶

Here is the list of system requirements that should be fulfilled to be able to install Akeneo PIM.

Operating Systems

Akeneo PIM only works on Linux servers. The application’s behaviour has been tested on several operating systems. We cannot guarantee the behaviour of the application on servers different from:

• RHEL stands for Red Hat Enterprise Linux.

Web server and configuration

We can only guarantee the behaviour on the following web server:

The web server will also need the following libraries and modules:

PHP required modules and configuration

Besides these modules, the following configuration is the minimal configuration required:

• Setup CLI php.ini file /etc/php/7.1/cli/php.ini

$ sudo vim /etc/php/7.1/cli/php.ini
memory_limit = 1024M
date.timezone = Etc/UTC

• Setup FPM php.ini file /etc/php/7.1/fpm/php.ini

$ sudo vim /etc/php/7.1/fpm/php.ini
memory_limit = 512M
date.timezone = Etc/UTC

To avoid spending too much time on permission problems between the CLI user and the FPM user, a good practice is to use the same user for both of them.

• Get your identifiers

$ id
uid=1000(my_user), gid=1000(my_group), ...

In this example, the user is my_user and the group is my_group.

• Stop FPM

$ sudo service php7.1-fpm stop

• Open the file /etc/php/7.1/fpm/pool.d/www.conf with your favorite text editor:

$ sudo vi /etc/php/7.1/fpm/pool.d/www.conf
# replace these environment variables:
user = my_user
group = my_group
listen = /run/php/php7.1-fpm.sock
listen.user = www-data
listen.group = www-data

• Restart FPM

$ sudo systemctl restart php7.1-fpm

Extra dependencies

Javascript

Database server

To use this database you will also require the distribution package:

and the following PHP modules:

Search engine

and the following Java Runtime Environment version

Network

The following ports should be opened on the server host for the PIM to work properly:

Files and folders access rights

Most of the application folders and files require only read access. Here is a list of folders that also need write access for the FPM user:

These permissions are the ones required by the Symfony Framework (see its official documentation for more information).

Akeneo PIM application uses an abstraction layer called Flysystem to store media and files uploaded from the application. By default, Flysystem is configured to store these files on the application server, but this configuration can easily be changed in favor of, for example, a distributed remote storage system (see Flysystem documentation for more information).

The var/uploads folder could be located elsewhere depending on the configuration you defined in the parameters.yml of your Akeneo PIM application instance.