Deploy OroCommerce on TurboStack

Deploy OroCommerce on TurboStack - PHP, MySQL, Redis and a RabbitMQ message queue - with an annotated example host YAML.

OroCommerce is a Symfony-based B2B commerce platform. TurboStack provisions the runtime and supporting services, including the message queue OroCommerce relies on for asynchronous processing.

Requirements

Requirement Recommended
App type orocommerce
Runtime PHP 8.4
Database MySQL 8.4 (or PostgreSQL)
Cache Redis
Message queue RabbitMQ (recommended for async jobs)
Web server Nginx (Varnish optional)

Configure it

  1. Open your host and go to the Applications tab.
  2. Select Add app or database and set App Type to orocommerce.
  3. Choose PHP 8.4 as the runtime and set the server name for your storefront.
  4. Enable MySQL, Redis, and RabbitMQ for the async message queue.
  5. Publish the host, then deploy your code.

Example configuration

webserver: nginx
mysql_version: "8.4"
redis_enabled: true
system_users:
  - username: prod
    vhosts:
      - server_name: oro.example.com
        app_type: orocommerce
        php_version: "8.4"
        cert_type: letsencrypt
        rabbitmq_enabled: true   # Oro uses a message queue for async jobs

Why these choices

  • app_type: orocommerce applies the OroCommerce runtime profile to the vhost.
  • RabbitMQ is strongly recommended because Oro offloads async jobs to a message queue.
  • MySQL 8.4 stores commerce data; PostgreSQL is supported as an alternative.
  • Redis provides caching and session storage for the Symfony application.
  • PHP 8.4 and Nginx match OroCommerce's supported stack.
  • Let's Encrypt provides automatic Transport Layer Security (TLS) for the storefront hostname.