metamaps--metamaps/doc/MacInstallation.md

# 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

    rake db:create
    rake db:schema:load
    rake db:seed
    rails server

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

To start the realtime server:

    cd realtime
    node realtime-server.js
centralize config in .env file, which includes remaving database.yml.default and overriding that file's local changes in favour of env variables. In future, all instance config can go in .env 2016-01-06 14:36:29 +00:00			`# OSX Install`

Update MacInstallation.md 2017-07-25 23:37:16 +00:00			`Install rvm (ruby version manager)`
Update MacInstallation.md 2014-09-21 23:19:19 +00:00
Update MacInstallation.md 2014-09-21 23:18:32 +00:00			`\curl -sSL https://get.rvm.io \| bash -s stable --rails`
Update MacInstallation.md 2017-07-25 23:37:16 +00:00
			`Use rvm to install Ruby version 2.3.0`

switch to ruby 2.3.0 (#572) 2016-08-01 00:33:45 +00:00			`rvm install 2.3.0 --with-gcc=clang`
			`rvm use 2.3.0`
Update MacInstallation.md 2014-09-21 23:18:32 +00:00
Update MacInstallation.md 2017-07-25 23:37:16 +00:00			`Now install homebrew. (a package manager for mac)`
centralize config in .env file, which includes remaving database.yml.default and overriding that file's local changes in favour of env variables. In future, all instance config can go in .env 2016-01-06 14:36:29 +00:00
			`ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
Update MacInstallation.md 2014-09-21 23:18:32 +00:00
Update MacInstallation.md 2017-07-25 23:37:16 +00:00			`Then install nodejs (make sure its version 6.11.1 or greater)`
centralize config in .env file, which includes remaving database.yml.default and overriding that file's local changes in favour of env variables. In future, all instance config can go in .env 2016-01-06 14:36:29 +00:00
			`brew install nodejs`
fix jquery error and move package.json etc to root dir 2016-08-03 14:37:02 +00:00			`npm install`
			`npm run build`
centralize config in .env file, which includes remaving database.yml.default and overriding that file's local changes in favour of env variables. In future, all instance config can go in .env 2016-01-06 14:36:29 +00:00
			`And postgresql:`
Update MacInstallation.md 2014-09-21 23:18:32 +00:00
			`brew install postgresql`
			`ln -sfv /usr/local/opt/postgresql/*.plist ~/Library/LaunchAgents`
			`createuser metamaps -P -s -d`

centralize config in .env file, which includes remaving database.yml.default and overriding that file's local changes in favour of env variables. In future, all instance config can go in .env 2016-01-06 14:36:29 +00:00			`Set a password, then start the service:`
Update MacInstallation.md 2014-09-21 23:18:32 +00:00
Update MacInstallation.md 2017-07-25 23:37:16 +00:00			`brew services start postgresql`
Update MacInstallation.md 2014-09-21 23:18:32 +00:00
centralize config in .env file, which includes remaving database.yml.default and overriding that file's local changes in favour of env variables. In future, all instance config can go in .env 2016-01-06 14:36:29 +00:00			`Change directory to the metamaps git repository, and run:`
Update MacInstallation.md 2014-09-21 23:18:32 +00:00
			`bundle install`

centralize config in .env file, which includes remaving database.yml.default and overriding that file's local changes in favour of env variables. In future, all instance config can go in .env 2016-01-06 14:36:29 +00:00			`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`
Update MacInstallation.md 2014-09-21 23:18:32 +00:00
			`rake db:create`
			`rake db:schema:load`
Update MacInstallation.md 2017-07-18 03:45:34 +00:00			`rake db:seed`
centralize config in .env file, which includes remaving database.yml.default and overriding that file's local changes in favour of env variables. In future, all instance config can go in .env 2016-01-06 14:36:29 +00:00			`rails server`

			`Now open a browser to http://localhost:3000!`
Update MacInstallation.md 2017-07-25 23:37:16 +00:00
			`To start the realtime server:`

			`cd realtime`
			`node realtime-server.js`