Installing Drupal Starter Kits through Cloud IDE

You can use Cloud IDE to create an Acquia-recommended Drupal project or add a starter kit to your existing Drupal project.

  • Create an Acquia-recommended Drupal project through Acquia CLI by running the following command:

    acli new
    1. Select acquia/drupal-recommended-project.

    By default, the starter kit is already available in this project.

  • Create an Acquia-recommended Drupal project through CLI by running the following command:

    composer create-project acquia/drupal-recommended-project .

    By default, the starter kit is already available in this project.

  • Add the starter kit to an existing Drupal project by running the following command:

    composer require acquia/acquia-cms-starterkit

After you create an Acquia-recommended Drupal project or add a starter kit to an existing Drupal project, you can install Drupal Starter Kits by leveraging one of the available starter kits. Acquia recommends that you use the Drupal Starter Kits starter kit wizard for downloading and building Drupal sites with Drupal Starter Kits modules. With this wizard, you can set up your Drupal site using one of the three starter kits. You can install Drupal Starter Kits by using one of the following starter kits:

Enterprise low-code starter kit

This starter kit installs the following to your Drupal site:

  • Drupal Starter Kits with Site Studio
  • A UIKit

It provides drag-and-drop content authoring and low-code site building. An optional add-on content model is available during the installation process. For more information, see Enterprise low-code starter kit.

To install Drupal Starter Kits through the Enterprise low-code starter kit:

  1. Access your Drupal project and run the following command:

    ./vendor/bin/acms acms:install
    
  2. In Please choose bundle from one of the above use case, select acquia_cms_enterprise_low_code and press Enter.

    For selection, you can use the Up and Down arrow keys.

  3. In Do you want to enable demo content?, type yes to see the operation of Drupal Starter Kits with a content model with demo content and Site Studio components with demo content. Otherwise, type the default value, no.
    • If you type no:
      1. In Do you want to enable the content model?, type yes or no and press Enter.

        This question includes all content types in the site.

  4. In Would you like to enable the Acquia DAM modules?, type yes to leverage Acquia DAM modules. Otherwise, type no.
  5. In Would you like to add GDPR functionality to the site?, type yes to leverage community-contributed GDPR modules with Drupal Starter Kits. Otherwise, type no. For more information about these modules, see General Data Protection Regulation and EU Cookie Compliance (GDPR Compliance).
  6. In Please provide the Google Maps API Key, type the Google Maps API key and press Enter.

    The starter kit wizard does not prompt for the key if you have already configured the environment variable with the export GMAPS_KEY="<your_key>" command. Also, you can skip this step if you do not have the key.

  7. In Please provide the Site Studio API Key, type the Site Studio API key and press Enter.

    The starter kit wizard does not prompt for the key if you have already configured the environment variable with the export SITESTUDIO_API_KEY="<your_key>" command. Also, you can skip this step if you do not have the key.

  8. In Please provide the Site Studio Organization Key, type the Site Studio Organization key and press Enter.

    The starter kit wizard does not prompt for the key if you have already configured the environment variable with the export SITESTUDIO_ORG_KEY="<your_key>" command. Also, you can skip this step if you do not have the key.

  9. Specify the database information, such as name, driver, username, password, host, and port.

  10. Continue the installation process until you get the confirmation message.
  11. If you are an existing Acquia customer who does not use the Site Studio Configuration Management module, do the following steps:
    1. (Optional) If you are already using the blt-site-studio plugin, remove it from your codebase by running the following command:

      composer remove acquia/blt-site-studio
      
      1. Remove the following lines from the blt/blt.yml file:

        site-studio:
          rebuild: true
          package-import: true
          cohesion-import: true
        
  12. Add the Site Studio Configuration Management module to your codebase by running the following command:

    composer require drupal/sitestudio_config_management
    
    1. Enable the module by running the following command:

      ./vendor/bin/drush en sitestudio_config_management -y
      
    2. Add the following lines to the settings.php file:

      $settings['config_sync_directory'] = '../config/default/sync';
      $settings['site_studio_sync'] = '../config/default/site_studio';
      
    3. Verify the configuration import and export commands by running the following commands:

      ./vendor/bin/drush cex
      ./vendor/bin/drush cim
      

      These commands must automatically export or import Site Studio configurations along with Drupal configurations based on the paths specified in your settings.php file.

After you install Drupal Starter Kits, you can develop your Drupal site and deploy your changes to Cloud Next.

Community starter kit

This starter kit installs Drupal Starter Kits to your Drupal site. An optional add-on content model is available during the installation process. For more information, see Community starter kit.

To install Drupal Starter Kits through the Community starter kit:

  1. Access your Drupal project and run the following command:

    ./vendor/bin/acms acms:install
    
  2. In Please choose bundle from one of the above use case, select acquia_cms_community and press Enter.

    For selection, you can use the Up and Down arrow keys.

  3. In Do you want to enable demo content?, type yes to see the operation of Drupal Starter Kits with a content model with demo content and Site Studio components with demo content. Otherwise, type the default value, no.
    • If you type no:
      1. In Do you want to enable the content model?, type yes or no and press Enter.

        This question includes all content types in the site.

  4. In Would you like to enable the Acquia DAM modules?, type yes to leverage Acquia DAM modules. Otherwise, type no.
  5. In Would you like to add GDPR functionality to the site?, type yes to leverage community-contributed GDPR modules with Drupal Starter Kits. Otherwise, type no. For more information about these modules, see General Data Protection Regulation and EU Cookie Compliance (GDPR Compliance).
  6. In Please provide the Google Maps API Key, type the Google Maps API key and press Enter.

    The starter kit wizard does not prompt for the key if you have already configured the environment variable with the export GMAPS_KEY="<your_key>" command. Also, you can skip this step if you do not have the key.

  7. Specify the database information, such as name, driver, username, password, host, and port.

  8. Continue the installation process until you get the confirmation message.

After you install Drupal Starter Kits, you can develop your Drupal site and deploy your changes to Cloud Next.

Headless starter kit

This starter kit pre-configures Drupal for serving structured, RESTful content to third-party content displays, such as mobile apps, smart displays, and frontend driven websites. For more information, see Headless starter kit.

To install Drupal Starter Kits through the Headless starter kit:

  1. Access your Drupal project and run the following command:

    ./vendor/bin/acms acms:install
    
  2. In Please choose bundle from one of the above use case, select acquia_cms_headless and press Enter.

    For selection, you can use the Up and Down arrow keys.

  3. In Do you want to enable demo content?, type yes to see the operation of Drupal Starter Kits with a content model with demo content and Site Studio components with demo content. Otherwise, type the default value, no.
    • If you type no:
      1. In Do you want to enable the content model?, type yes or no and press Enter.

        This question includes all content types in the site.

  4. In Would you like to enable the Acquia DAM modules?, type yes to leverage Acquia DAM modules. Otherwise, type no.
  5. In Would you like to preconfigure a next.js site?, type yes to configure a Next.js website. Otherwise, type no.
    • If you type yes:
      1. In Please provide the Next.js site url, type the Next.js site URL.
      2. In Please provide the Site Name, type the name of the site.
      3. In Please provide the .env.local file path, type the path of the .env.local file.
  6. In Please provide the Google Maps API Key, type the Google Maps API key and press Enter.

    The starter kit wizard does not prompt for the key if you have already configured the environment variable with the export GMAPS_KEY="<your_key>" command. Also, you can skip this step if you do not have the key.

  7. Specify the database information, such as name, driver, username, password, host, and port.

  8. Continue the installation process until you get the confirmation message.

After you install Drupal Starter Kits, you can develop your Drupal site and deploy your changes to Cloud Next.

 

Did not find what you were looking for?

If this content did not answer your questions, try searching or contacting our support team for further assistance.

Back to Section navigation