[[install-run]]

=== Running the Interactive Installer

[role="summary"]
How to use the interactive installer to install the core software.

(((Installer tool,running)))
(((Installation process)))
(((Installation profile)))
(((Profile,installation)))
(((Database,configuring during the installation process)))
(((Core software,installing)))
(((Drupal core,installing)))
(((Web installer,running)))

==== Goal

Install the core software and create the admin account by running the included
installer.

// ==== Prerequisite knowledge

==== Site prerequisites

<<install-prepare>>

==== Steps

. If you are using a 1-click install from a hosting provider or demo site, you
will most likely see some or all of the following screens as part of the
installation process. If you uploaded the core files manually or using Composer,
to start the installer, open a browser and visit the URL that you set up for
your hosting.

. Select a language on the first page of the installer; for example,
English. You could optionally choose from any of the other listed languages.
The language files for the chosen language will be downloaded and installed so
that the rest of the installation process can be finished in the chosen
language. After choosing a language, click _Save and continue_.
+
--
// Go to the first step of the installer
image:images/install-run-1.png["Choose a language",width="100%"]
--

. Select an installation profile. Installation profiles provide site features
and functions for a specific type of site as a single download containing
the core software, contributed modules, themes, and pre-defined
configuration. Core contains two installation profiles. Select the core
Standard installation profile. Click _Save and continue_.
+
--
// Go to the choose an installation profile step of the installer
image:images/install-run-2.png["Choose an installation profile",width="100%"]
--

. The next step in the installer will verify that your system meets the minimum
requirements. If it does not, you'll be presented with an outline of what
needs to be corrected in order to proceed. If it does, the installer will
automatically advance to the next step.

. Provide details of the database you created in the <<install-prepare>>
chapter. Then click _Save and continue_.
+
[width="100%",frame="topbot",options="header"]
|================================
|Field name | Explanation | Value
|Database name | The custom name given to the database | drupal8
|Database username | Username created | databaseUsername
|Database password | Password chosen | ************
|================================
+
--
// Go to the database configuration step of the installer
image:images/install-run-3.png["Database configuration form",width="100%"]
--

. The next step will display a progress bar under the heading _Installing
Drupal_. After the installer has completed, it will automatically advance to
the next step.
+
--
// Go to the page displaying the installation progress bar
image:images/install-run-4.png["Installation progress bar",width="100%"]
--

. The next step is to configure some basic information about your new site
(also notice if there is a warning about file permissions, for a later step).
Note that the user account you create in this step is the site's admin
account. See <<user-admin-account>> for important information about this unique
account. You can safely name this account "admin", and make sure to choose a
secure and unique password.
+
Fill in the form with the following information:
+
[width="100%",frame="topbot",options="header"]
|================================
|Field name | Explanation | Value
|Site name | The name chosen for the site | Anytown Farmers Market
|Site email address | The email associated with the site | info@example.com
|Username | The designated user's credentials| admin
|Password | The password chosen | ************
|Confirm password | Repeat the password | ************
|Email address | The user's email | admin@example.com
|================================
+
The remaining fields can likely be left at their default values.
+
--
// Go to the basic site information configuration step of the installer
image:images/install-run-5.png["Configuration form",width="100%"]
--

. Click _Save and continue_.

. You will be redirected to the front page of your new site and you should see
the message _Congratulations, you installed Drupal!_ displayed at the top of
the page.
+
--
// Front page of Drupal after the installer just completed showing the success message
image:images/install-run-6.png["Installation success",width="100%"]
--

. You may have seen a warning in the Configuration step about file permissions,
and you may continue to see this warning until you fix the permissions. To
avoid the warning and make your site more secure, change the permissions on the
_sites/default_ directory and the _sites/default/settings.php_ file so that they
are read-only (you may need to consult your hosting company documentation about
how to do that).

==== Expand your understanding

Check the Status Report to see if there are any problems with the
installation. See <<prevent-status>>.

==== Related concepts

* <<install-dev-sites>>
* <<install-tools>>

==== Videos

// Video from Drupalize.Me.
video::https://www.youtube-nocookie.com/embed/LGfRKKKDjv8[title="Running the Installer"]

==== Additional resources

* https://www.drupal.org/docs/8/install/step-3-create-a-database[Drupal.org community documentation page "Create A Database"]
* https://www.drupal.org/server-permissions[Drupal.org community documentation section "Webhosting issues"]


*Attributions*

Written and edited by https://www.drupal.org/u/eojthebrave[Joe Shindelar] at
https://drupalize.me[Drupalize.Me],
and https://www.drupal.org/u/jojyja[Jojy Alphonso] at
http://redcrackle.com[Red Crackle].
