You can install the Mortar Development Framework with one command on the following operating systems:
To perform the installation, open your Terminal application and run:
curl -sSL install.mortardata.com | bash
If you don't yet have a Mortar login, you can request a free trial.
Once the Mortar Development Framework is installed and you have signed up for an account, open your terminal and run:
$ mortar login Enter your Mortar credentials. Email: email@example.com Password (typing will be hidden): Authentication successful.
Since Mortar snapshots your code to private Mortar repositories at GitHub, you'll be prompted for your GitHub username.
Please enter your github username (not email address). GitHub Username: yourgithubusername Setting GitHub username: Done!
Upon success, you will receive an email from GitHub inviting you to join the mortarcode organization.
Accept the invite, and you'll be ready to create private (or public, if you wish) projects in Mortar.
In order to push code to GitHub, you'll need to be logged into GitHub with SSH.
To test whether your GitHub SSH login is active, run the following in a terminal:
$ ssh -T firstname.lastname@example.org Hi yourgithubuser! You have successfully authenticated, but GitHub does not provide shell access.
You should see a message saying that you've successfully authenticated to GitHub.
If you have a passphrase for your SSH key, have multiple SSH keys, or are trying out the Vagrant sandbox, you will want to use
ssh-agent to add your keys. This helps avoid being prompted for a password or having to specify which key you want to use each time you run a mortar command. We use the common key path and name of id_rsa in the example below. Modify these settings to the key and path you set up when following the github instructions above.
First make sure you have the proper permissions on your key if you copied or moved it around.
chmod 0600 ~/.ssh/id_rsa
Next start ssh-agent and load your key.
ssh-agent /bin/bash ssh-add ~/.ssh/id_rsa
If you would like to try Mortar without installing anything on your local workstation or on a non Unix OS such as Windows, you can use our Vagrant-based sandbox installer.
First, you'll need to meet the following prerequisites:
With those prerequisites in place, follow these steps:
Vagrantfileif you have run through these steps before (ensures you get the latest and greatest)
TRY_MORTARicon on the desktop
id_rsaso you will need to choose a different name for your github keys in the vm
vagrant haltfrom your local workstation to stop the Vagrant sandbox
You can also choose to install the Mortar Framework using Rubygems.
First, you'll need to make sure the following prerequisites are installed first:
Use your distribution's package manager to install JDK 6. Note that package installation directories change over time so your
JAVA_HOME may be in a different directory then what is listed listed below. To confirm that your
JAVA_HOME is correct after installation, you should check that
Finally, install the Mortar framework via gem:
gem install mortar --no-rdoc --no-ri