Deploy Akeneo on TurboStack

Deploy Akeneo PIM on TurboStack - PHP, MySQL, required Elasticsearch, Redis and job queues - with an annotated example host YAML.

Akeneo is a Product Information Management (PIM) platform for centralizing and enriching product catalogs. TurboStack provisions the full runtime, the search index Akeneo depends on, and runs its background job queues for you.

Requirements

Requirement Recommended
App type akeneo
Runtime PHP 8.4
Database MySQL 8.4 (or PostgreSQL)
Search Elasticsearch/OpenSearch 8.x (required for the product index)
Cache Redis
Web server Nginx

Configure it

  1. Open your host and go to the Applications tab.
  2. Select Add app or database and set App Type to akeneo.
  3. Choose PHP 8.4 as the runtime and a server name for the PIM vhost.
  4. Enable the required services: MySQL, Elasticsearch/OpenSearch, and Redis.
  5. Publish the host to apply the configuration.

Example configuration

webserver: nginx
mysql_version: "8.4"           # Akeneo catalog database
elasticsearch_version: "8.x"  # REQUIRED: product/index search
redis_enabled: true
system_users:
  - username: prod
    vhosts:
      - server_name: pim.example.com
        app_type: akeneo
        php_version: "8.4"
        cert_type: letsencrypt

Why these choices

  • app_type: akeneo tells TurboStack to apply the Akeneo runtime profile and run its background job queues.
  • Elasticsearch/OpenSearch is mandatory because Akeneo stores its product and catalog index there.
  • MySQL 8.4 holds the catalog data; PostgreSQL is supported as an alternative.
  • Redis provides fast caching and session handling for the PIM.
  • Nginx and PHP 8.4 match Akeneo's recommended web stack.
  • Let's Encrypt issues and renews Transport Layer Security (TLS) for the PIM hostname automatically.