Requirements & System Compatibility

Before installing and configuring the Webkul Multi Company SaaS Extension for Magento 2, ensure that your hosting environment and Magento 2 instance meet the required software versions and dependencies.

Core System Requirements

1. Magento & Adobe Commerce Platform

• Cloud & On-Premise Support: Functions seamlessly in on-premise dedicated servers, VPS, AWS EC2, Google Cloud Platform, and Adobe Commerce on Cloud infrastructure.
• Operating Mode: For live environments, ensure Magento is set to production mode (php bin/magento deploy:mode:set production) to maximize asset delivery performance.

2. PHP Environment & Configuration

Recommended php.ini Directives

Ensure your PHP runtime allocates sufficient memory and execution time to handle recurring subscription lifecycle jobs and code compilation:

memory_limit = 2G              ; Minimum 2G (4G recommended for setup:di:compile)
max_execution_time = 18000     ; Prevent timeout during static content deployment
zlib.output_compression = On
opcache.enable = 1
opcache.memory_consumption = 512
opcache.max_accelerated_files = 100000
opcache.save_comments = 1

3. Web Server, Wildcard DNS & SSL

• Wildcard DNS: Point an A or CNAME record for *.yourdomain.com to your server IP for dynamic vendor subdomain resolution.
• Wildcard SSL Certificate: Install a wildcard TLS certificate (*.yourdomain.com) to secure all seller subdomains over HTTPS.
• Public Webhook Ingress: Ensure the server is accessible over public HTTPS to receive Stripe and PayPal recurring billing webhooks.

4. Database Engine (MySQL / MariaDB)

• Engine: The database storage engine must be set to InnoDB.
• Recommended Configuration in my.cnf:

  innodb_buffer_pool_size = 2G  ; Allocate 50-70% of available server RAM in production
  max_allowed_packet = 64M
  wait_timeout = 600
  interactive_timeout = 600
  
• SQL Mode: Ensure SQL mode is aligned with standard Magento 2 defaults (avoid non-standard strict modes that could break core third-party queries).

5. Search Engine (OpenSearch / Elasticsearch)

Magento 2.4.x requires a running OpenSearch or Elasticsearch service for catalog indexing and storefront search:

• OpenSearch: Versions 1.3.x, 2.x (standard and recommended for Magento 2.4.6 and above).
• Elasticsearch: Versions 7.17.x or 8.x.
• Default Port 9200:

curl -s -XGET http://localhost:9200

6. Background Automation (Magento Cron Daemon)

The SaaS recurring billing system depends on the Magento cron scheduler running every minute without interruption.

# Add to your web server user's crontab (e.g., crontab -u www-data -e)
* * * * * /usr/bin/php /var/www/html/bin/magento cron:run 2>&1 | grep -v "Ran jobs by schedule" >> /var/www/html/var/log/magento.cron.log

7. Composer & Memory Optimization

• Composer Version: Composer 2.x (version 2.2+ LTS recommended).
• Memory Management: When installing packages via Composer on systems with constrained RAM, always set the memory limit flag:

COMPOSER_MEMORY_LIMIT=-1 composer require stripe/stripe-php:~16.0.0

Required Module Dependencies

1. Webkul Magento 2 Multi-Vendor Marketplace (webkul/module-marketplace): Provides seller account architecture, marketplace management grids, and seller commission calculation hooks.
2. Webkul Magento 2 Vendor Subdomain (webkul/vendor-sub-domain): Provides DNS wildcard/subdomain routing infrastructure that maps seller handles to tenant storefronts.

Required Third-Party PHP SDKs

To support recurring automated billing cycles and webhook listeners, the following SDK libraries must be installed via Composer:

Install both SDKs in your Magento root directory:

composer require stripe/stripe-php:~16.0.0
composer require paypal/rest-api-sdk-php:*

Module Architectural Restrictions

Verification Commands

Confirm that required PHP extensions and composer packages are available:

# Verify essential PHP extensions
php -m | grep -E 'curl|json|mbstring|openssl|zip'

# Verify prerequisite Webkul modules
php bin/magento module:status Webkul_Marketplace Webkul_VendorSubDomain