Install: Mac OSX
This page shows you how to install Terraspace on Mac OSX.
Here’s a “Mac OSX Homebrew Install” Video:
Homebrew
You can install Terraspace via homebrew.
Install
brew tap boltops-tools/software
brew install terraspace
Upgrade
cd terraspace-project
vim Gemfile # edit the terraspace version if it's pinned
bundle update terraspace
Uninstall
brew uninstall terraspace
Cleanup
rm -rf /opt/terraspace
grep -l /opt/terraspace /usr/local/bin/* | xargs rm -f
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
.
DMG
You can also download the dmg and install with the Mac OSX GUI installer.
Download link: Terraspace DMG
You can check terraspace-latest.dmg.metadata.json to verify the package checksum. Here’s the checksum command.
shasum -a 256 terraspace-latest.dmg