Setup Wizard installation

Totally lost? Need a helping hand? Try our installation quick reference (tutorial) or installation roadmap (reference).

If you chose to enable SELinux, see SELinux and iptables.

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:

  1. Your system meets the requirements discussed in Magento System Requirements.
  2. You completed all prerequisite tasks discussed in Prerequisites.
  3. 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.

Examples:

  • 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 require field in Magento’s composer.json file for each module. Conflicts are declared in the conflict field in modules’ composer.json files. We use that information to build a dependency graph: A->B means 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 A->B->C.

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

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

Getting started

To install the Magento software using the Setup Wizard:

  1. Start a web browser.

  2. Enter the following URL in the browser’s address or location bar:

    1
    
    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:

    1
    
    http://192.0.2.10/magento2/setup
    
  3. On the initial page, click Agree and Set Up Magento.

  4. Continue with the following topics in the order presented to complete the installation.

Related topics

Step 1: Readiness Check