Skip to content

Latest commit

 

History

History
77 lines (46 loc) · 1.81 KB

INSTALL.OSX.rst

File metadata and controls

77 lines (46 loc) · 1.81 KB

Installing Hypothes.is on OSX

Run the following commands from the directory where you've cloned this repository.

Install Homebrew:

ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)"

Install python:

brew install python

Install virtualenv:

pip install virtualenv

Install Node and other required tools:

gem install compass
brew install node
npm -g install uglify-js
npm -g install clean-css
npm -g install coffee-script

Add the tools' path to the $PATH variable:

echo "export PATH=/usr/local/share/python:/usr/local/share/npm/bin:\$PATH" >> ~/.profile
source ~/.profile

Install Elasticsearch (Optional)

Elasticsearch is required in order to store annotations locally. Take care that you install a version that meets the requirements listed in INSTALL.rst. You can check what is available via Homebrew with:

brew info elasticsearch

If an appropriate version is available then follow the instructions below, otherwise get a version from http://www.elasticsearch.org/.

brew install elasticsearch

To have Elasticsearch run automatically at login:

ln -sfv /usr/local/opt/elasticsearch/*.plist ~/Library/LaunchAgents
launchctl load ~/Library/LaunchAgents/homebrew.mxcl.elasticsearch.plist

To launch it manually without launchctl:

elasticsearch -f -D es.config=/usr/local/opt/elasticsearch/config/elasticsearch.yml

Next Steps

After installing the above, create the virtualenv, as described in INSTALL.rst.