Roots Documentation

# Ubuntu Linux

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

# Global Dependencies

# Git

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"

# Composer

Install Composer from the standard Ubuntu software repositories:

$ sudo apt-get install composer

# SSH Keys

# Creating an 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 keys:

$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

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

# Add your SSH key to the ssh-agent

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_rsa

# Working with Sage

Sage relies on a few build tools to manage dependencies and build assets. Install these tools:

  • nvm
  • Node.js
  • yarn

# nvm

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

# Node.js

Install the latest Node.js LTS release from nvm:

$ nvm install --lts

# yarn

Install yarn:

$ npm install --global yarn

# Working with Trellis

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

  • VirtualBox >= 4.3.10
  • Vagrant >= 1.8.5
  • Ansible >= 2.4

# VirtualBox

Install VirtualBox:

$ sudo apt-get install virtualbox

# Vagrant

Download the latest version of Vagrant and install it with dpkg -i:

$ sudo dpkg -i vagrant_2.2.3_x86_64.deb

# Ansible

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

← Windows (WSL) →