Installing a Drupal distribution


  • The Acquia Remote Administration service is incompatible with the process defined in this page.
  • Composer-based installs are recommended for real applications. For more information, see BLT.

You can install a Drupal distribution (or Drupal core) using the Acquia Cloud Platform interface or Cloud IDE. A Drupal distribution is a custom edition of Drupal, tuned and extended with custom developed and contributed modules to enable desired features, such as Acquia CMS. You can install many of the best and most popular Drupal distributions on Acquia Cloud Platform. For a list, see Choosing a Drupal distribution.

You can install a Drupal distribution (or Drupal core) using one of the following methods:

Installing a new Drupal distribution through the Acquia Cloud Platform user interface

  1. Sign in to the Cloud Platform user interface and select the application and environment where you want to install Drupal. You cannot install Drupal in a Production environment.

  2. On the environment’s Overview page, click Install Drupal.

    Click the Install Drupal button


    If Install Drupal is disabled for use, ensure that the following required items are in place for your environment:

    • The Code entity in the environment has a branch or trunk selected—you cannot install to a tag.
    • Live Dev mode must be disabled for your application. Live Dev expects Drupal installation attempts only from the command line.
  3. On the Install distribution page, locate the Drupal distribution that you want to install, and then click Install. For many distributions, you can click Learn more to receive more information about a distribution.

  4. To install a distribution that’s not listed (for example, your organization may have its own Drupal distributions, or you may want to install another distribution from, click Install from URL. In the Install Drupal from URL dialog, enter the URL of the distribution.


    For Drupal 7, the URL of the distribution’s download file (must be in .tar.gz format). The URL of the distribution’s Drush .make file.

    Install another distro

  5. In the Install Drupal from URL dialog, click Install.

Deploying a new Drupal distribution in an environment takes a few minutes. After the installation process completes, click the environment’s website URL to visit your Drupal website. This runs install.php to complete the Drupal installation. The Drupal install.php script opens in a new browser window. The script creates a standard Drupal database, sets up the administrator username and password, and configures other modules and features relevant to the Drupal distribution you chose.

Install Drupal

To start modifying your code, make a local copy of the repository using the Git checkout command.

Installing a new Drupal distribution in an Acquia Cloud IDE

Cloud IDE also offers a convenient and opinionated way to install Drupal.

To install a Drupal distribution using a Cloud IDE:

  1. Launch your Cloud IDE. If you have not yet created a Cloud IDE, follow the instructions on Getting started with Cloud IDE.

  2. From the IDE Get Started page, click create a new Drupal application in your Cloud IDE.

    Install Drupal in Cloud IDE

    A terminal pane pops up and prompts you to install the Acquia Drupal recommended project or the Acquia Drupal minimal project.

  3. Select your target version by typing the number associated with your distribution selection in the terminal prompt and press Enter. Acquia CLI takes care of automatic installation of Drupal in Cloud IDE’s /home/ide/project directory.

    ACLI Drupal Install

    After Drupal is installed, you can start developing or push from the IDE terminal to Acquia Cloud Platform with acli push:db and acli push:files. As a best practice, your codebase remains to be managed with Git.