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
Important
Akeneo cannot start without a search engine. The product and catalog index lives in Elasticsearch/OpenSearch, so enable it before publishing.
Configure it
- Open your host and go to the Applications tab.
- Select Add app or database and set App Type to
akeneo. - Choose PHP 8.4 as the runtime and a server name for the PIM vhost.
- Enable the required services: MySQL, Elasticsearch/OpenSearch, and Redis.
- 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
Tip
Pin a specific release with the optional akeneo_version key if your project targets a particular Akeneo version.
Why these choices
app_type: akeneotells 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.
Related
-
Technologies used: PHP, MySQL, Elasticsearch.
-
Best practices - performance & stability.
-
Troubleshooting - logs & common fixes.