[PaaS only]{class="badge informative" title="Applies to Adobe Commerce on Cloud projects (Adobe-managed PaaS infrastructure) and on-premises projects only."}

On-premises installation overview

This page provides an overview of installing Adobe 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 Adobe Commerce on-premises 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 Adobe 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.

Merchant responsibilities

With Adobe Commerce on-premises, you host and manage your own infrastructure, including servers, hosting environments, and system maintenance. Adobe provides support specifically for the core Commerce application, including:

  • Access to product updates and fixes
  • Security patches to address vulnerabilities
  • Comprehensive documentation to assist you with managing and optimizing your self-hosted solution

You have full control over your environment, allowing for greater customization and flexibility, but you are responsible for ensuring the infrastructure’s performance, security, and scalability. For example, you are responsible for the following:

  • The design, implementation, configuration, maintenance, troubleshooting and performance testing of all Adobe Commerce on premises systems.
    • Servers, operating system, databases, PHP, search, caching, full page cache, and content delivery network. Common themes may include (but not limited to) Nginx/Apache, PHP, MySQL/MariaDB, Redis, Elasticsearch/OpenSearch, RabbitMQ, Varnish, DNS, SSL/TLS certificates, and any CDN used.
  • Capacity planning, auto scaling, clustering, backups, disaster recovery
  • All product and customer data, design, configuration and setup, application and database upkeep, code deployment, version upgrades, and patch application
  • Monitoring & alerting via APM/logging/alerting (for example, New Relic, Datadog, ELK)
  • Security patching for operating system, PHP, database, middleware hardening and updates

Workflow

The following diagram illustrates the main steps involved in installing Adobe 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 Adobe Commerce Composer packages.

Get the Adobe 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, clone 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