Install and test Drupal Distribution

Needs revision -- Last peer review: 11 Sep 2014
Install a custom Drupal Distribution/Install Profile

This lesson walks you through installing a Drupal distribution.


1. Find a Drupal distro here: (For example, Drupal Commons.)

2. Download and unzip the distro. (If you look inside, it should look like a standard Drupal download with one or two exceptions. Look inside the 'profiles' directory. You should see an installation profile with a name that corresponds to the distro you selected. This is where custom installation instructions for this distro live. You may also see contributed modules in side profiles/my-profile/modules or sites/all/modules. Unlike core Drupal, distros frequently come packaged with additional open source projects required to make the distro work.)

3. Create a new database and take note of the user name and password. If you're using a GUI tool, please see instructions for that tool. Here's how you do this from the command line (e.g. database name: example, user name: example, host: localhost, password: 12345):

$ mysql
$ mysql> create database example;
$ mysql> grant all on example.* to 'example'@'localhost' identified by '12345';

4. Most sites will default to something like http://localhost/example. You can set up the distro to live at like this (example uses MAMP):

Add this here /etc/hosts:

Add this here /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf:

<VirtualHost *>
DocumentRoot "/path/to/example"

4. Go to /path/to/example/sites/default. Copy default.settings.php to settings.php. And create a files directory.

5. Now go to http://localhost/example or in your browser. Select the install profile when prompted. And follow Drupal's installation instructions.

Lesson tags:


Use the Control Panel -> Settings -> Sites, and the Import button. The site path should be where your new downloaded drupal distro unzipped to.