Getting Started with Roots Sage, Trellis, and Bedrock on Ubuntu Linux

Trellis, Bedrock, and Sage development on Ubuntu Linux is supported by several libraries and software packages.

Global Dependencies

Git is available from the standard Ubuntu software repositories and may be installed with the following command:

$ sudo apt-get install git

Configure Git with your user information:

$ git config --global user.name "Your Name"
$ git config --global user.email "yourname@example.com"

Install Composer from the standard Ubuntu software repositories:

$ sudo apt-get install composer

Trellis and GitHub both use SSH keys to communicate securely without the need to type a username and password each time. Create your SSH keys:

$ ssh-keygen -t ed25519 -C "your_email@example.com"

For more details on generating SSH keys, see GitHub's excellent documentation.

Modify your ~/.ssh/config file to automatically load keys into the ssh-agent and store passphrases in your keychain.

Edit your ~/.ssh/config file and add the following lines:

Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519

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

Install yarn:

$ npm install --global yarn

Trellis relies on a few other software tools. Install these tools:

Install VirtualBox:

$ sudo apt-get install virtualbox

$ sudo dpkg -i vagrant_2.2.14_x86_64.deb

Install pip (Python package manager) if you don't already have it:

$ sudo apt-get install python-pip

Install Ansible with pip:

$ pip install ansible

# Install a specific Ansible version:
$ pip install ansible==2.4.0.0