Trellis, Bedrock, and Sage development on macOS 10.13+ is supported by several libraries and software packages.
Trellis, Bedrock, and Sage development on macOS relies on several libraries and software packages. This guide will show you how to install and configure each of these recommended packages on your computer. This guide assumes basic knowledge of command line and terminal usage.
- Xcode Command Line Tools
# Xcode Command Line Tools
Install Xcode Command Line Tools using the built-in command:
$ xcode-select --install
Git is automatically installed as part of the Xcode Command Line tools. Configure Git with your user information:
$ git config --global user.name "Your Name" $ git config --global user.email "firstname.lastname@example.org"
Install Homebrew from the instructions at https://brew.sh, or with the following command:
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Install Composer from Homebrew:
$ brew install composer
# SSH keys
# Create SSH key
Trellis and GitHub both use SSH keys to communicate securely without the need to type a username and password each time. Create your SSH key and add them to your macOS Keychain:
$ ssh-keygen -t rsa -b 4096 -C "email@example.com"
For more details on generating SSH keys, see GitHub's excellent documentation.
# Add your SSH key to the ssh-agent
~/.ssh/config file to automatically load keys into the ssh-agent and store passphrases in your keychain.
~/.ssh/config file and add the following lines:
Host * AddKeysToAgent yes UseKeychain yes IdentityFile ~/.ssh/id_rsa
# Working with Sage
Sage relies on a few build tools to manage dependencies and build assets. Install these tools:
Install nvm from the instructions at https://github.com/creationix/nvm, or with the following command:
$ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.34.0/install.sh | bash
Install the latest Node.js LTS release from nvm:
$ nvm install --lts
$ npm install --global yarn
# Working with Trellis
Trellis relies on a few additional software packages to function. Install these packages:
- VirtualBox >= 4.3.10
- Vagrant >= 2.1.0
- Ansible >= 2.5.3
Download and install the "OS X Hosts" version of VirtualBox from https://www.virtualbox.org/wiki/Downloads
Install Vagrant from Homebrew:
$ brew cask install vagrant
Install pip (Python package manager) if you don't already have it:
$ sudo easy_install pip
Install Ansible with pip:
$ pip install ansible # Install a specific Ansible version: $ pip install ansible==22.214.171.124
For macOS Catalina or later, you will have to grant full disk access to
- Navigate to System Preferences → Security & Privacy → Privacy → Full Disk Access
- Press Command Shift G at the same time.
- Enter the
- Double click the