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