metamaps--metamaps/doc/MacInstallation.md
2017-07-26 09:22:06 -07:00

1.6 KiB

OSX Install

Install rvm (ruby version manager)

\curl -sSL https://get.rvm.io | bash -s stable --rails

Use rvm to install Ruby version 2.3.0

rvm install 2.3.0 --with-gcc=clang
rvm use 2.3.0

Now install homebrew. (a package manager for mac)

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Then install nodejs (make sure its version 6.11.1 or greater)

brew install nodejs
npm install
npm run build

And postgresql:

brew install postgresql
ln -sfv /usr/local/opt/postgresql/*.plist ~/Library/LaunchAgents
createuser metamaps -P -s -d

Set a password, then start the service:

brew services start postgresql

Change directory to the metamaps git repository, and run:

bundle install

Copy the .example-env file and rename it to .env. Then modify the DB_USERNAME and DB_PASSWORD values to match the postgres username and password you set

Now use rake to create and set up the database

rake db:create
rake db:schema:load
rake db:seed

To start the rails server:

rails server

To start the realtime server:

node realtime/realtime-server.js

NOTE: if you want to actively develop on the javascript in /frontend use

npm run build:watch

to start a webpack build process that updates the build everytime you make code changes

Now open a browser to http://localhost:3000!

Sign in with the default account

email: user@user.com
password: toolsplusconsciousness

OR create a new account at /join, and use access code 'qwertyui'

Start mapping and programming!