DocumentationCommerceInstallation Guide

PaaS only

On-premises installation overview

Last update: April 17, 2024
  • Topics:
  • Install

CREATED FOR:

  • Experienced
  • Admin
  • Developer
NOTE
The following diagram provides a high-level overview of on-premises installations of Adobe Commerce:

How installation works

The general installation flow is as follows:

  1. Set up your server environment.

    Install the prerequisite software, including PHP, Apache, MySQL, and the search engine. See the system requirements for more information.

  2. Get authentication keys to the Commerce Composer repository.

  3. Get the Adobe Commerce software.

    • (Recommended) Get the Composer metapackage to manage modules and their dependencies.

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

  4. Install the application using the command line.

    If the step fails because prerequisite software isn’t set up correctly, review the prerequisites.

  5. Verify the installation by viewing your storefront and the Admin.

Commerce

  • Overview
  • System requirements
  • Prerequisites
    • Overview
    • File system
      • Overview
      • Configure permissions
    • Web server
      • Nginx
      • Apache
    • Database server
      • MySQL
      • Remote connections
    • Search engine
      • Overview
      • AWS OpenSearch
      • Configure Nginx
      • Configure Apache
    • PHP
    • Message broker
    • Security
    • Authentication keys
    • Adobe Commerce
    • Optional software
  • Quick start installation
  • Advanced installation
  • Post-installation steps
    • Verify the installation
    • Configure the application
    • Set a umask (optional)
    • Install sample data (optional)
      • Overview
      • Download Composer packages
      • Clone Git repositories
      • Remove or update modules
  • Tutorials
    • Backup and rollback the file system, media, and database
    • Check the database status
    • Configure message consumer behavior
    • Configure the lock provider
    • Configure the store
    • Create, edit, or unlock admin accounts
    • Create or update the deployment configuration
    • Create the database schema
    • Display or change the Admin URI
    • Enable or disable maintenance mode
    • Enable or disable modules
    • Install an extension
    • Install Commerce
    • Modify docroot to improve security
    • Uninstall language packages
    • Uninstall modules
    • Uninstall or reinstall Commerce
    • Uninstall themes
    • Upgrade the database schema
  • Return to Operational Guides