This section discusses how to install the Magento software using a web-based wizard interface. To install Magento from the command line, see Install Magento software using the command line.
Before you start your installation
Before you begin, make sure that:
- Your system meets the requirements discussed in Magento System Requirements.
- You completed all prerequisite tasks discussed in Prerequisites.
- After you log in to the Magento server, switch to the Magento file system owner.
Enabling and disabling modules
The Setup Wizard enables you to enable or disable modules before you install the Magento software. Before you do so, make sure you understand the following.
Magento enables you to enable or disable currently available modules; in other words, any Magento-provided module or any third-party module that is currently available.
Certain modules have dependencies on other modules, in which case you might not be able to enable or disable a module because it has dependencies on other modules.
In addition, there might be conflicting modules that cannot both be enabled at the same time.
Module A depends on Module B. You cannot disable Module B unless you first disable Module A.
Module A depends on Module B, both of which are disabled. You must enable module B before you can enable module A.
Module A conflicts with Module B. You can disable Module A and Module B, or you can disable either module but you cannot enable Module A and Module B at the same time.
Dependencies are declared in the
requirefield in Magento’s
composer.jsonfile for each module. Conflicts are declared in the
conflictfield in modules’
composer.jsonfiles. We use that information to build a dependency graph:
A->Bmeans module A depends on module B.
A dependency chain is the path from a module to another one. For example, if module A depends on module B and module B depends on module C, then the dependency chain is
If you attempt to enable or disable a module that depends on other modules, the dependency graph displays in the error message.
It’s possible that module A’s
composer.json declares a conflict with module B but not vice versa.
Command line module enable or disable subcommand only: To force a module to be enabled or disabled regardless of its dependencies, use the optional
--force can disable your Magento store and cause problems accessing the Magento Admin.
Running the Setup Wizard
The Setup Wizard is a multi-page wizard that enables you to go back and forward one page at a time. You cannot skip pages, and you must enter all required information on every page before you can proceed to the next page.
In the event of errors, you can run the installer again or you can return to a previous page to fix errors on that page.
To install the Magento software using the Setup Wizard:
Start a web browser.
Enter the following URL in the browser’s address or location bar:
http://<Magento host or IP>/<path to Magento root>/setup
For example, if the Magento server’s IP address is 192.0.2.10 and you installed Magento 2 in the
magento2/directory relative to the web server’s docroot, and you did not configure a Virtual Host, enter:
On the initial page, click Agree and Set Up Magento.
Continue with the following topics in the order presented to complete the installation.