Note
Acquia will end support for BLT on December 31, 2024. For more information on how to replace your BLT implementation with updated functionality, see You don’t need BLT on Acquia Cloud.
You must use Composer to install BLT. Don’t clone the BLT repository unless you are contributing to the BLT project.
General requirements
Regardless of the operating system you use, you must have the following installed tools available for use from the command line:
Install the most recent versions of dependencies unless otherwise noted.
Networking considerations
Building project dependencies requires your local computer to make HTTP and HTTPS requests to several remote software providers. Your local- and network-level security settings must not block requests.
If you must make requests using a proxy server, configure Git to use a proxy, which will address all Git-based requests made by Composer.
Installing dependencies
Use the following procedures (based on your operating system) to install the necessary dependencies listed above.
To install BLT dependencies on macOS, complete the following steps:
Ensure that you have installed Xcode. Xcode is required to support Homebrew, and you can install Xcode on macOS 10.9 or later by running the following commands:
sudo xcodebuild -license xcode-select --installInstall the minimum dependencies for BLT. Although you can use the following commands to use Homebrew to install the needed packages, you are not required to use a package manager:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" brew install php git composerInstall the BLT Launcher so that the BLT alias functions properly.
Install Drush only as a dependency of individual projects (instead of installing Drush system-wide). BLT will manage this dependency for you with projects, but for you to run Drush commands independently of BLT commands, install the Drush Launcher.
Set up your LAMP stack for use with your development. See Local development with BLT.
Installing BLT
Once the necessary host machine’s prerequisites are installed, BLT can be installed for use on a project through one of the following methods:
Adding to an existing project that runs the current Drupal version: Adding BLT to an existing project
Starting a new project: Creating a project with BLT
If BLT is already set up for your project and you need instructions on how to get started, see Onboarding with BLT. If you are trying to update an existing version of BLT, see Updating BLT.