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
    
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!
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`
Update MacInstallation.md 2017-07-25 23:47:33 +00:00
			`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`
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
			`Now open a browser to http://localhost:3000!`
Update MacInstallation.md 2017-07-25 23:47:33 +00:00
			`Sign in with the default account`
Update MacInstallation.md 2017-07-25 23:37:16 +00:00
Update MacInstallation.md 2017-07-25 23:47:33 +00:00			`email: user@user.com`
			`password: toolsplusconsciousness`

			`OR create a new account at /join, and use access code 'qwertyui'`
Update MacInstallation.md 2017-07-25 23:37:16 +00:00
Update MacInstallation.md 2017-07-25 23:47:33 +00:00			`Start mapping and programming!`