Install: Ubuntu/Debian

This page shows you how to install Terraspace on Ubuntu and Debian based linux systems that use the apt package manager.

Ubuntu/Debian: apt-get install

Configure repo

sudo su
echo "deb https://apt.boltops.com stable main" > /etc/apt/sources.list.d/boltops.list
curl -s https://apt.boltops.com/boltops-key.public | apt-key add -

Install

apt-get update
apt-get install -y terraspace

Upgrade

cd terraspace-project
vim Gemfile # edit the terraspace version if it's pinned
bundle update terraspace

Remove

apt-get remove -y terraspace

Generated Wrappers

By default, the standalone installer creates wrapper scripts in /usr/local/bin. Here are some of them:

/usr/local/bin/bundle
/usr/local/bin/gem
/usr/local/bin/rspec
/usr/local/bin/ruby
/usr/local/bin/terraspace

Most users have /usr/local/bin configured in their PATH. So these wrappers work immediately. If you wish not to have these wrappers generated for you, set export TS_WRAPPERS=0 before running the installer.

Important: If you have ruby wrappers in /usr/local/bin already, the installer will overwrite them.

Why Upgrade with bundle?

You should use bundle to upgrade terraspace because it’ll ensure that all of your project gem dependencies are installed, not just terraspace. The standalone installs an embedded version of ruby, bundle, and terraspace in /opt/terraspace/embedded. It’ll work on the first install on a clean machine, but is will likely not work when upgrading because the embedded install has a different set of gem dependencies than your project’s Gemfile.lock.

Deb Install

You can also download the deb package and install it directly. Here are the commands:

Install

wget https://apt.boltops.com/packages/terraspace/terraspace-latest.deb
dpkg -i terraspace-latest.deb

You can check terraspace-latest.deb.metadata.json to verify the package checksum. Here’s the checksum command.

sha256sum terraspace-latest.deb

Uninstall

dpkg -r terraspace-latest.deb

More tools: