Information for: DEVELOPERS   PARTNERS

Installing Dev Studio CLI

Important

Dev Studio CLI will reach end-of-life on March 30, 2021. Acquia will no longer support Dev Studio CLI after March 30, 2021. Dev Studio CLI is replaced by Acquia CLI and Acquia Cloud IDE. Acquia recommends you to move from Dev Studio CLI to Acquia CLI and Acquia Cloud IDE which are more secure, reliable, and scalable.

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

Requirements

Before you install Dev Studio, be sure you have the following items installed on your computer or available to you:

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

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

Lando includes an easy-to-use interface, and is a preferred tool for many participants in the Drupal community. Lando’s Github project is active, with fast turnaround times on issues and frequent releases. It supports container customizations allowing developers full control of their local stack.

  • 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

Lando is dependent on Docker, and Docker’s incompatibility with older versions of Windows can prevent some users from successfully installing Lando.

  • 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.

Dev Studio limitations

The Dev Studio command-line interface (CLI) is incompatible with Drupal 7.

Installation procedure

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

To install Dev Studio CLI, complete the following steps:

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

  2. Run the following command:

    curl https://downloads.acquia.studio/install-standalone.sh | bash
    
  3. Enter the information for sudo access to install Dev 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 Cloud Platform 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 Dev Studio CLI, complete the following steps:

  1. Download and run the Dev 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 Cloud Platform 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 Dev Studio

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

ads update