Akeneo 3 preferably requires a Hypernode Professional M hosting plan or larger. You can either choose to install it on a seperate Hypernode instance or on the same Hypernode as your Magento or Shopware installation. If you choose the latter you have to make sure that you have enough resources (disk space, memory and CPU) left. Furthermore you need to make sure that you are already using MySQL 5.7, PHP 7.2 and Elasticsearch 6.x, so it won’t affect your shop negatively. Installing Akeneo version 3.x may take up to 15 minutes

Enable managed_vhosts

Create a managed_vhost for a (sub)domain

If your Magento or Shopware installation already points to example.hypernode.io, you can create a managed_vhost for your Akeneo installation on a subdomain, for example akeneo.example.hypernode.io. The command below will also install Let’s Encrypt and force your domain to use HTTPS.

Upgrade to MySQL 5.7

Important: After an update to MySQL 5.7, it’s not possible to switch to MySQL 5.6.

Upgrade your PHP version

Before installing Akeneo, make sure your PHP version is changed to PHP 7.2.


Enable and configure Elasticsearch v6

Install Node.js v10.16

After Node.js has been installed you can check if it’s correctly set by running node -v. This should output v10.16.0.

Install Yarn latest version

Download and install Akeneo 3 using the command line

Download and unzip the latest stable release to /data/web/akeneo.

Download Akeneo sample data

If you want to start with preconfigured demo data also known as ‘icecat’

Download Akeneo without sample data

If you want to start a fresh blank catalog also known as ‘minimal’

Unpack Akeneo

After you’ve downloaded Akeneo unpack it.

Setting up Akeneo

First change the MySQL username and password in ~/akeneo/pim-community-standard/app/config/parameters.yml to your own credentials.

Create an administrator user

Fill in the form with a Username, Password, First name, Last name, Email and local code.

Finish the installation

Restart PHP-FPM

Tada! Your Akeneo-installation is now available on akeneo.example.hypernode.io!

Configure your Akeneo cron

After installing Akeneo, configure your cron by adding these scripts to your crontab file:


  • Error when installing Akeneo: No alive nodes found in your cluster
    Make sure ElasticSearch is enabled.

  • When creating a user in Akeneo: Property “user_default_locale” expects a valid locale code. The locale does not exist, “en_US” given.
    Akeneo wasn’t installed properly, probably because elasticsearch wasn’t enabled in the first place.

  • request.CRITICAL: Uncaught PHP Exception “index_not_found_exception”,”reason”:”no such index”
    There may be mismatches in the Elastic index. Reset the Elasticsearch indexes: