Wiki

Install for Mac OS X (10.7 - 10.11)

Last revision: 5 January 2016

Download

Download Google Chrome and install (follow installer instructions)
Download Node.js and install (either LTS or Stable - follow installer instructions)
Download homebrew and install (Terminal command creates full install)
- If you get a popup about installing the 'command line developer tools', select 'Install'
  - Press 'Return' in Terminal once command line tools install finishes
- Run brew doctor once install finishes

Install Dependencies

Open Terminal
- brew install ffmpeg --with-libvpx --with-libvorbis --with-ffplay
  - make sure to have ffmpeg v3.xxx
- brew install imagemagick --with-ghostscript --with-webp --with-fontconfig
- brew install exiftool

Clone SAGE2

Open Terminal
- cd <directory_to_install_SAGE2>
- git clone https://bitbucket.org/sage2/sage2.git

Generate HTTPS Keys

Open the file 'GO-mac' in a text editor (inside the '<SAGE2_directory>/keys/' folder)
- Add additional host names for your server in the variable servers (optional)
- Save file
Open Terminal
- cd <SAGE2_directory>/keys
- ./GO-mac
  - enter your password when asked (the keys are added into the system)

Install Node.js Modules

Open Terminal
- cd <SAGE2_directory>
- npm run in (install pre-compiled binary modules) or npm install (compile and install binary modules)

Errors

When running npm run in and error is given stating: "fatal error: 'libavcodec/avcodec.h' file not found #include <libavcodec/avcodec.h>". Xcode isn't searching /usr/local/ for include files or libraries. Open Terminal and execute the following command: xcode-select --install

When starting SAGE2 an error is given regarding a node module that is missing a dependency. If the error is regarding a libavXXX file, check the /usr/local/lib for libav links. Should the folder not have the specified files, this means the brew installation of ffmpeg did not fully complete. Try reinstall ffmpeg with brew. This may require using brew link and/or brew override commands.

If the following error is produced:

Assertion failed: (!uv__io_active(&stream->io_watcher, UV__POLLOUT) || !ngx_queue_empty(&stream->write_completed_queue) || !ngx_queue_empty(&stream->write_queue) || stream->shutdown_req != NULL || stream->connect_req != NULL), function uv_read_stop, file ../deps/uv/src/unix/stream.c, line 1329.

Abort trap: 6

The current solution is to update node to the most recent (0.10.36+, 0.12.7+, 4.2.3+, or 5.1.0+)