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
Experience League

Learn

  • Playlists
  • Tutorials
  • Instructor-led training
  • Browse all learning content

Documentation

  • Documentation home
  • Experience Cloud release notes
  • Document Cloud release notes

Certifications

  • Certifications home

Events

  • Events home

Community

  • Community home
  • Advertising Cloud
  • Analytics
  • Audience Manager
  • Campaign Standard
  • Experience Cloud
  • Experience Manager
  • Experience Platform
  • Magento Commerce
  • Marketo Engage
  • Target
  • Workfront, an Adobe company
  • Feedback Program

Support

  • Experience Cloud Support
  • Document Cloud Support
  • Community forums

Resources

  • Adobe I/O
  • Adobe Status

Adobe Account

  • Profile
  • Bookmarked content

Adobe

  • About
  • Careers
  • Newsroom
  • Corporate responsibility
  • Investor Relations
  • Supply chain
  • Trust Center
  • Events
  • Diversity & Inclusion
  • Integrity
DeutschEnglishEspañolFrançaisItalianoNederlandsPortuguêsSvenska中文 (简体)中文 (繁體)日本語한국어
Copyright © 2025 Adobe. All Rights Reserved./Privacy/Terms of Use/Cookie preferences/Do not sell my personal information/ AdChoices