
Installing Drupal – the detailed version
This version goes over each step in more detail and includes screenshots.
- Download the core Drupal codebase from http://drupal.org/project/drupal.
- Extract the codebase on your local machine.
Tip
The Drupal codebase (and all modules and themes) are compressed into a tarball, or a file that is first tarred, and then gzipped. Such compressed files end in
.tar.gz
.On Macs and Linux machines,
tar.gz
files can be extracted automatically using tools that come preinstalled with the operating system. On PC's, you can use 7-zip, an open source compression utility available at http://www.7-zip.org. - In your web browser, navigate to your system's URL for phpMyAdmin. If you are using a different tool for creating and managing your database, use that tool to create your database and database user.
- As shown in the following screenshot, create the database on your server. Click on the Create button to create your database.
Tip
Store your database name in a safe place. You will need to know your database name to complete your installation.
- To create your database user, click on the SQL tab as shown in the following screenshot. In the text area, enter the following SQL statement:
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER ON databasename.* TO 'username'@'localhost' IDENTIFIED BY 'password';
- For
databasename
, use the name of the database you created in step 4. Replace theusername
andpassword
with a username and password of your choice. Once you have entered the correct values, click on the Go button to create the user with rights on your database:Tip
Store the username and the password of your database user in a safe place. You will need them to complete the installation.
- Create and/or locate the directory from where you want Drupal to run. In this example, we are running Drupal from within a folder named
drupal7
; this means that our site will be available athttp://ourdomain.org/drupal7
.Tip
Running Drupal in a subfolder can make things a little trickier. If at all possible, copy the Drupal files directly into your web root.
- Using your FTP client, upload the Drupal codebase to your web folder:
- Navigate to the URL of your site. The automatic install wizard will appear on your screen:
- Click the Save and continue button with the Standard option selected.
- Click the Save and continue button with the English (built-in) option selected.
- To complete the Set up database screen, you will need the database name (created in step 4) and the database username and password (created in step 6). Select MySQL, MariaDB, or equivalent as the Database type and then enter these values in their respective text boxes as seen in the following screenshot:
- Most installs will not need to use any of settings under ADVANCED OPTIONS. However, if your database is located on a server other than localhost, you will need to adjust the settings as shown in the next screenshot.
Tip
In most basic hosting setups, your database is accessible at localhost.
To verify the name or location of your database host, you can use phpMyAdmin (as shown in the screenshot under step 4) or contact an administrator for your web server. For the vast majority of installs, none of the advanced options will need to be adjusted.
- Click on the Save and continue button. You will see a progress meter as Drupal installs itself on your web server.
- On the Configure site screen, you can enter some general information about your site, and create the first user account. The first user account has full rights over every aspect of your site. When you have finished with the settings on this page, click on the Save and continue button.
- When the install is finished, you will see the following splash screen:
Note
Additional details on installing Drupal are available in the handbook at http://drupal.org/documentation/install.