Install Documents

Akeneo is an open-source Product Information Management (PIM) system. It requires PHP, Elasticsearch, MySQL, and Composer.

Prerequisites

• Ubuntu 20.04 or 22.04
• PHP 8.1, MySQL 8.0, Composer, Node.js
• At least 4 GB RAM (Elasticsearch requirement)

Install PHP Extensions

apt install php-cli php-apcu php-bcmath php-curl php-opcache php-fpm \
  php-gd php-intl php-mysql php-xml php-zip php-mbstring php-imagick
apt install apt-transport-https -y

Install Elasticsearch

# Add Elasticsearch 8.x repo
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

# Set vm.max_map_count (required for Elasticsearch)
sysctl -w vm.max_map_count=262144
echo 'vm.max_map_count=262144' | tee /etc/sysctl.d/elasticsearch.conf

service elasticsearch start

Install Akeneo PIM

# Create project with Composer
composer create-project akeneo/pim-community-standard \
  /srv/pim '6.0.*'
cd /srv/pim

# Install dependencies
composer install
yarn install
yarn run webpack

# Set up database
php bin/console pim:install --env=prod

# Set permissions
chown -R www-data:www-data /srv/pim

Verify

service elasticsearch status
php bin/console debug:container | grep akeneo

Notes

• Akeneo requires Elasticsearch — it will not function without it.
• Add vm.max_map_count=262144 to /etc/sysctl.conf for persistence across reboots.
• For production, configure Nginx as a reverse proxy and set up queue consumers as systemd services.