Skip to content

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 "Your Name"
$ git config --global ""


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 ed25519 -C ""

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_ed25519

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, or with the following command:

$ curl -o- | bash


Install the latest Node.js LTS release from nvm:

$ nvm install --lts


Install yarn:

$ npm install --global yarn

Working with Trellis

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


Install VirtualBox:

$ sudo apt-get install virtualbox


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

$ 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==