DocumentationCommerceInstallation Guide

PaaS only

On-premises installation overview

Last update: July 23, 2025
  • Topics:
  • Install

CREATED FOR:

  • Experienced
  • Admin
  • Developer

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 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.

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