11.3. Downloading and Installing a Module from Drupal.org

Last updated on
14 April 2025

Goal

Download and install the contributed Admin Toolbar module, which allows you to easily browse through the administration section of the website.

Site prerequisites

Steps

You can use the administrative interface or Drush to install a contributed module. If you are installing a custom module rather than a contributed module, if you see a message saying Installing modules and themes requires FTP access to your server, or if the steps below do not work to download and unpack the module files, follow the steps in 第 11.6 节 “Manually Downloading Module or Theme Files”. If you are installing a contributed module with external dependencies that are managed by Composer, follow the steps for downloading in 第 11.9 节 “Using Composer and Git to Download Files”. In either of these cases, then continue here with step 7 in the instructions for the administrative interface below.

Using the administrative interface

  1. On the Admin toolbar project page on drupal.org (https://www.drupal.org/project/admin_toolbar), scroll to the Downloads section at the bottom of the page.
  2. Copy the address of the tar.gz link. Depending on your device and browser, you might do this by right clicking and selecting Copy link address.

    Finding a module URL

  3. In the Manage administrative menu, navigate to Extend (admin/modules). The Extend page appears.
  4. Click Install new module. The Install new module page appears.

    Installing a module from a URL

  5. In the field Install from a URL, paste the copied download link. This value could look like this: https://ftp.drupal.org/files/projects/admin_toolbar-8.x-1.14.tar.gz
  6. Click Install to upload and unpack the new module on the server. The files are being downloaded to the modules directory.
  7. Click Enable newly added modules to return to the Extend page. If you used the manual uploading procedure, start with this step, and reach the Extend page by using the Manage administrative menu and navigating to Extend (admin/modules).
  8. Locate and check Admin toolbar.
  9. Click Install to turn on the new module.

Using Drush

  1. Find the project name for the module you want to install, which is the last segment of the module’s project page URL. For example, if the project URL is https://www.drupal.org/project/admin_toolbar, the project name is "admin_toolbar".
  2. Run the following Drush commands, giving the project name (for example, admin_toolbar) as a parameter:

    drush dl admin_toolbar
    drush en admin_toolbar
  3. Follow the instructions on the screen.

Expand your understanding

 

This page is generated from AsciiDoc source from the User Guide. To propose a change, edit the source and attach the file to a new issue in the User Guide project. PDF and e-book formats are available on the User Guide project page.

Source file: extend-module-install.asciidoc

Help improve this page

Page status: No known problems

You can: