Installing a Drupal distribution¶

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.

   

   Note

   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 drupal.org), click Install from URL. In the Install Drupal from URL dialog, enter the URL of the distribution.

   Note

   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.

   

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.

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.

   

   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.

   

   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.