Step 4: Run the installation script

Last updated June 9, 2012. Created by emmajane on April 25, 2008.
Edited by markewhite@me.com, Carolyn, arianek, Shai. Log in to edit this page.

For Drupal 7

To run the Drupal install script, point your browser to the base URL of your web site.
The "base URL" means the document root (directory) where you placed your Drupal files (and is defined in your web server configuration file). If you have installed Drupal on a web host this will likely be a domain name such as http://www.example.com. If you installed Drupal in a subfolder, then you should point your browser to the subfolder (e.g. http://example.com/subfolder). If you have installed Drupal on your desktop machine this URL might be http://localhost/drupal.

If the installation process does not simply appear by entering the base URL of your site, add the file name "install.php" (for example http://www.example.com/install.php).

You will be guided through several screens:

1. Choose which profile to use for the installation (standard or minimal).
   Most people should select the "standard" option. The standard option comes with default content types already enabled, such as Article and Page, and with appropriate publishing options already set. (Of course you can later edit these default content types and their settings, or add additional ones.) The standard profile also has a useful collection of modules pre-enabled for you.

   The "minimal" option is targeted toward more experienced Drupal site creators who wish to set up their own content types with associated publishing options. The minimal profile has only three modules enabled: Block, Database logging, and Update status.

   

2. Select a language
   If you want to install using a language other than the default English, click the Learn how to install Drupal in other languages link.

   

3. Verify requirements
   If your installation directory is not yet configured properly, you will be informed at this step. You can correct the settings individually and either refresh the browser screen or click 'Try again' to see whether there are any errors left.

   

   Possible errors include:

   • Missing directories and/or incorrect permissions
     The installer will attempt to automatically set up a number of directories, but this may fail due to permission settings. In this case you will find the missing directories listed.
     • sites/default/files
     • sites/default/private
     • sites/default/private/files

     These directories should be set to the following permissions chmod o+w sites/default/files OR chmod 777 sites/default/files

   • Missing settings.php or incorrect permissions
     If settings.php is missing or not accessible, follow the instructions in Step 3: The settings.php file. Note that you will need both the default.settings.php and settings.php files.
4. Set up database
   Enter the database name as well as the username and password for the database that you created in Step 2: Create the database. This username and password information allows Drupal to access your database, so the install script can create tables. Note that this is not the username and password for administering Drupal; these will be created in the next step.

   

   The Advanced options will allow you to change the database host ('localhost' is usually used in this entry: wamp/bin/apache/Apache2.2.11/bin/php.ini as an example of the location on a Windows box running WAMP). You can also change the port and the table prefix. You only need to change the port if you are using a non-standard port number. The table prefix is useful if you are installing multiple instances of Drupal tables that share the same database.

   Click Save and continue at the bottom of the page.

5. Install profile
   A progress bar will appear and display notes from the installer regarding the progress of the installation. If no errors are encountered, the next page will automatically load in your browser.



6. Configure site
   Input the information for the first user account (which will be automatically assigned full administration permissions) and provide basic web site settings.
   • In the Site name field enter the name you wish to use for the site. You can also edit it later through the administration interface.
   • In the Site e-mail address field, enter the e-mail address that will be used by Drupal when it sends out notifications such as registration information.
   • In the Site maintenance account field, enter the Username, E-mail address, and password for the main administration account.

     Note that there is a distinction, as of Drupal 7, between the main administration account that you set up on this page, and the "Administrator" site administrator user role that you will see when you visit the "Roles" and "Permissions" pages in the administration interface. The account you set up in the Site maintenance account section during installation is a super-user who has overall control over every aspect of the management and configuration of the site. (This will be http://www.example.com/user/1, for those of you familiar with that account from earlier versions of Drupal.)
     

   • In the Server settings field, select your Default country and Default time zone.
   • In the Update notifications field leave both boxes checked if you want your Drupal server to alert you when updates are required. Often updates relate to security issues and are important to perform. However, if you have restricted Internet connectivity (for example if you are behind a corporate firewall) you may want to leave these settings unchecked and test them later.
     

   Click "Save and continue". On success you will see the Drupal installation complete screen. If there are any error messages, review and correct them now.
   

Secure your site

After the installation is complete, you will want to change the permissions on the settings.php file back so that it is protected:

chmod u=rw,o=r,a=r sites/default/settings.php OR chmod 644 sites/default/settings.php

If you make manual changes to the settings.php file later, be sure to protect it again after making your modifications.

Failure to remove write permissions to that file is a security risk. (Although the default location for the settings.php file is at sites/default/settings.php, it may be in another location if you use the multi-site setup.)

For Drupal 6

To run the install script point your browser to the base URL of your website.

The base URL is defined in your Web server configuration file and is specific to the document root where you placed your Drupal files. If you have installed Drupal on a Web server this will likely be a domain name such as http://example.com. If you have installed Drupal on your desktop machine this URL might be http://localhost.

You will be guided through several screens to set up the database, create tables,

add the first user account and provide basic web site settings.

If you get any errors regarding the files directory and its permissions, read more information about the Files directory.