Skip to content

Latest commit

 

History

History
76 lines (46 loc) · 3.17 KB

INSTALL.md

File metadata and controls

76 lines (46 loc) · 3.17 KB

BLT installation

Please do not clone BLT as a means of using it. The only reason to clone BLT is to contribute outside the context of a particular Drupal site.

System requirements

You must have the following tools on the command line of your host operating system:

Installing requirements

Mac OSX

Ensure that Xcode is installed. On OSX 10.9+ you can install Xcode with:

    xcodebuild -license
    xcode-select --install

Then install the minimum dependencies for BLT. The preferred method is via Homebrew, though you could install these yourself without a package manager.

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
    brew tap homebrew/dupes; brew tap homebrew/versions; brew tap homebrew/homebrew-php;
    brew install php56 git composer drush
    composer global require "hirak/prestissimo:^0.3"

If you'd like to create a VM with BLT, you will require the following additional libraries. If you'd like to use a LAMP stack other than Drupal VM, see Local Development.

    brew tap caskroom/cask
    brew install ansible
    brew cask install virtualbox vagrant

The minimum required versions are VirtualBox 5.1.x and Vagrant 1.8.6. The local PHP environment should also have a memory limit of at least 2G for BLT to initialise.

If you'd like to execute Behat tests from the host machine, you will need Java:

    brew cask install java
    brew install chromedriver

Windows

Windows is currently supported only when using the Bash on Ubuntu on Windows feature available in the latest version of Windows 10.

Pre-requisite requirements:

  • You must be running a 64-bit version of Windows 10 Anniversary update (build 14393 or later)
  • Access to a local account with administrative rights for initial install

Follow the official installation guide.

Note you must create a UNIX username with a password when prompted at the final step in the process. Certain BLT commands will not function correctly if you install with a passwordless root account.

Once complete follow the BLT on Windows installation instructions.

Linux

If you are using a Linux machine, it is assumed that you will not be using Drupal VM and that you will be configuring your own LAMP stack. Disregard the blt vm command and @[project.machine_name] references in subsequent documentation.

Ubuntu / Debian

    apt-get install git composer drush
    composer global require "hirak/prestissimo:^0.3"

Fedora

    dnf install git composer drush
    composer global require "hirak/prestissimo:^0.3"

Installing BLT

Choose your own adventure: