Information for: DEVELOPERS   PARTNERS

How to install a Drupal 7 module

Drupal allows you to add modules to your codebase providing added features by installing contributed modules to the module archive at Drupal.org.

Procedure

After selecting an appropriate new module, you must install and enable the module on your website using one of the two primary installation methods:

Note for Acquia Cloud subscribers

For information about uploading the module’s files to your codebase, see Using your code repository.

Installing modules using the user interface

Use the following procedure to install a module from the Drupal interface:

  1. Download and extract the module you want to use to your website’s docroot/sites/all/modules/ directory. For more information about the docroot directory, see the Docroot definition.
  2. Sign in to your website as an administrator.
  3. View the Modules page by using one of the following methods:
    • In the administrative menu, click Modules.
    • In your browser’s address bar, go to http://[your_site]/admin/modules (where [your_site] is your website’s URL).
  4. In the module list, find the module you installed, and then select its checkbox.
  5. Scroll to the bottom of the webpage, and then click Save configuration.

Installing modules using Drush

For more advanced users familiar with the command line, you can also install and enable modules using a Drush command. The Drush command requires you to connect to your server by using SSH. For more information, see Managing applications using the command line. To install a module using Drush, complete the following steps:

  1. Open a command prompt to access your website’s code.

  2. Using the cd command, navigate to your website’s docroot.

  3. Run the following command:

    drush en module_name
    

    where module_name is the project name from Drupal.org. (For example, the project name for the Acquia Connector module is acquia_connector, from https://www.drupal.org/project/acquia_connector).

    Note

    You can append -y to the preceding command to accept the confirmation questions Drush displays.

Next steps

After you install a module on your website, you will configure the module’s settings, or make changes to the website user permissions. For more information, ensure you review the documentation provided either with your module, or on your module’s Drupal.org project page.