Information for: DEVELOPERS   PARTNERS

Installing Acquia Developer Studio

Use the information on this page to help you to install Acquia Developer Studio on your computer or in your development environment.

Requirements

Before you install Acquia Developer Studio, ensure you have the following items installed on your computer or available to you:

To execute all available commands, you should also have an Acquia Cloud account. Be sure to perform the following configuration steps to your account:

Use the following criteria when evaluating which development framework to use:

  • Container-based (Docker)
  • Less mature than Drupal VM
  • Must first be installed as a system process
  • Not as resource intensive as Drupal VM, which can affect boot times
  • Virtual machine-based
  • More mature than Lando
  • Requires sudo access
  • Requires Acquia BLT
  • Installed on a per-project basis
  • Requires more resources than Lando, affecting boot times
  • Requires Virtualbox and Vagrant

After you install all required software, be sure to restart your terminal.

Acquia Developer Studio limitations

Acquia Developer Studio has the following limitations:

  • The Acquia Developer Studio command-line interface (CLI) supports only development with Drupal 8.
  • Acquia Developer Studio CLI commands are compatible only with Acquia Cloud, and are not compatible with Acquia Cloud Site Factory.
  • Acquia Developer Studio CLI requires and uses Acquia BLT.

Installation procedure

After confirming that you meet the previously listed requirements use the following procedures to install Acquia Developer Studio, depending on your installed operating system:

To install Acquia Developer Studio CLI, complete the following steps:

  1. Open a command-prompt window on your local computer.

  2. Run the following command:

    curl https://s3.amazonaws.com/acquia-ads-cli/install-standalone.sh | bash
    
  3. Enter the information for sudo access to install Acquia Developer Studio to /usr/local/bin.

  4. If you haven’t already added an SSH key to your Acquia profile, complete the following steps:

    1. Run the following command to configure the connection to the Acquia Cloud API, and follow the prompts:

      ads api:setup
      

      If you need to generate a new API key and API secret, see Generating an API token.

    2. Run the following command to create an SSH key:

      ads ssh-key:create
      

To install Acquia Developer Studio CLI, complete the following steps:

  1. Download and run the Acquia Developer Studio CLI installation file.

  2. Open a command-prompt window on your local computer.

  3. If you haven’t already added an SSH key to your Acquia profile, complete the following steps:

    1. Run the following command to configure the connection to the Acquia Cloud API, and follow the prompts:

      ads api:setup
      

      If you need to generate a new API key and API secret, see Generating an API token.

    2. Run the following command to create an SSH key:

      ads ssh-key:create
      

Updating Acquia Developer Studio

To update Acquia Developer Studio after you have installed the application, run the following command from a command prompt window:

ads update