ÃÛ¶¹ÊÓÆµ

[PaaS only]{class="badge informative" title="Applies to ÃÛ¶¹ÊÓÆµ Commerce on Cloud projects (ÃÛ¶¹ÊÓÆµ-managed PaaS infrastructure) and on-premises projects only."}

On-premises installation overview

This page provides an overview of installing ÃÛ¶¹ÊÓÆµ Commerce on your own infrastructure. The installation process involves setting up your server environment, obtaining the necessary software and credentials, and running the installation command.

You can install the ÃÛ¶¹ÊÓÆµ Commerce software in approximately 30 to 60 minutes. However, the time required to set up your server environment before installation varies based on your experience and the technologies that you select.

TIP
You should have intermediate technical knowledge and server access to proceed successfully.

The installation creates a fully functional ÃÛ¶¹ÊÓÆµ Commerce store with both a customer-facing storefront and an administrative panel. You must have your database credentials, domain information, and authentication keys ready before beginning the process.

Workflow

The following diagram illustrates the main steps involved in installing ÃÛ¶¹ÊÓÆµ Commerce for on-premises environments:

How installation works

Set up your server environment

Install and configure PHP, web server, database, and search engine according to the prerequisites.

Get authentication keys

Generate new authentication keys (or copy existing keys) from the Commerce Marketplace to access ÃÛ¶¹ÊÓÆµ Commerce Composer packages.

Get the ÃÛ¶¹ÊÓÆµ Commerce software

Download using Composer (recommended) or clone from GitHub for development contributions.

If you want to contribute to the Magento Open Source codebase or customize the application, the GitHub repository. This method requires familiarity with both GitHub and Composer.

Install the application

Run the installation command with your specific configuration. See the quick start for complete examples.

NOTE
If the steps fail because prerequisite software is not set up correctly, review the prerequisites.

Verify the installation

Test your storefront and admin panel to ensure everything works correctly.

Common installation issues

  • Permission errors: Ensure proper file system ownership and permissions
  • Database connection failures: Verify database credentials and network connectivity
  • Authentication key errors: Confirm that your Commerce Marketplace keys are valid and active
  • Memory limits: Ensure sufficient PHP memory allocation (minimum 2GB recommended)
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995