Information for: DEVELOPERS   PARTNERS

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 or Lightning.

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

To install a new Drupal distribution in a Cloud Platform environment, complete the following steps:

  1. Sign in to the Cloud Platform 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.
    • Livedev mode must be disabled for your application. Livedev 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. If you aren’t sure which Drupal distribution to use, select Lightning.

  4. If you want 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. It must be either:

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

    Install another distro

    Then, 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.