manual_system_installation_debian11.rst

System installation on Debian 11 (Buster)

Here is a quick guide to set up the system_requirements manually on Debian 11. This guide will help you to install all the packages and modules needed for Akeneo PIM on a freshly installed Debian 11 system and then configure the application to match your local installation.

Warning

Please perform the following commands as root.

System installation

MySQL 8.0

The easiest way to install MySQL 8.0 is to use the official vendor package.

Follow the official documentation: https://dev.mysql.com/doc/refman/8.0/en/linux-installation-debian.html.

Download the bundle package for the required version:

$ wget https://downloads.mysql.com/archives/get/p/23/file/mysql-server_8.0.30-1debian10_amd64.deb-bundle.tar

And follow the aforementioned documentation.

When installing MySQL 8.0, you'll have to choose the authentication method. Please select Use Legacy Authentication Method as the Strong Password Encryption is not yet supported by Akeneo PIM.

PHP 8.1

As Debian 11 only provides PHP 7.4, we need to use Ondrej Sury packages to install PHP 8.1..

$ wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
$ sh -c 'echo "deb https://packages.sury.org/php/ buster main" > /etc/apt/sources.list.d/php.list'
$ apt-get update

Install PHP and the required extensions:

$ apt-get install php8.1-cli php8.1-apcu php8.1-bcmath php8.1-curl php8.1-opcache php8.1-fpm php8.1-gd php8.1-intl php8.1-mysql php8.1-xml php8.1-zip php8.1-mbstring php8.1-imagick

Elasticsearch 8.4

Follow the official Elasticsearch documentation: official vendor package:

• first install the PGP key
• then install the package via the official repository

$ apt-get install apt-transport-https
$ wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | apt-key add -
$ echo "deb https://artifacts.elastic.co/packages/8.x/apt stable main" | tee -a /etc/apt/sources.list.d/elastic-8.x.list
$ apt update && apt-get install elasticsearch=8.4.2
$ service elasticsearch start

Warning

You will probably need to increase the MAX_MAP_COUNT Linux kernel setting. Proceed as follow (first command will affect your current session, second one every boot of your machine):

$ sysctl -w vm.max_map_count=262144
$ echo "vm.max_map_count=262144" | tee /etc/sysctl.d/elasticsearch.conf
$ service elasticsearch restart

Apache

$ apt-get install apache2
$ a2enmod rewrite proxy_fcgi
$ service apache2 restart

Note

If you migrate from Apache with mod_php, don't forget to deactivate it by running the following commands

$ a2dismod php5

Node 18

$ apt-get install curl
$ curl -sL https://deb.nodesource.com/setup_18.x -o nodesource_setup.sh
$ bash nodesource_setup.sh
$ apt-get install -y nodejs

To check which version of Node.js you have installed after these initial steps, type:

$ nodejs -v

Yarn

$ curl -sL https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add -
$ echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list
$ apt update && apt-get install yarn