metamaps--metamaps/doc/MacInstallation.md

# OSX Install

If you are doing an upgrade and or recent pull for changes you will need to change your default ruby package from 2.1.1 to ruby 2.1.2

Some of these steps are pulled from http://www.moncefbelyamani.com/how-to-install-postgresql-on-a-mac-with-homebrew-and-lunchy/

Install homebrew

    \curl -sSL https://get.rvm.io | bash -s stable --rails
    rvm install 2.3.0 --with-gcc=clang
    rvm use 2.3.0
    gem install lunchy 

Now install homebrew. 

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

Then install nodejs and frontend code

    brew install nodejs
    (cd frontend && 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:

    lunchy start postgres

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:fixtures:load
    rails server

Now open a browser to http://localhost:3000!
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`

updates to all walkthroughs about the fact that we now use rails 2.1.2 as well as a couple changes to the get involved lightbox 2014-10-14 03:18:25 +00:00			`If you are doing an upgrade and or recent pull for changes you will need to change your default ruby package from 2.1.1 to ruby 2.1.2`

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			`Some of these steps are pulled from http://www.moncefbelyamani.com/how-to-install-postgresql-on-a-mac-with-homebrew-and-lunchy/`

			`Install homebrew`
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`
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			`gem install lunchy`

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 install homebrew.`

			`ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
Update MacInstallation.md 2014-09-21 23:18:32 +00:00
finish integrating npm. move underscore/backbone into npm management (#577) * finish integrating npm. move underscore/backbone into npm management * update docs for npm integration * allow jsx or js extension * change underscore version 2016-08-01 19:59:53 +00:00			`Then install nodejs and frontend code`
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`
finish integrating npm. move underscore/backbone into npm management (#577) * finish integrating npm. move underscore/backbone into npm management * update docs for npm integration * allow jsx or js extension * change underscore version 2016-08-01 19:59:53 +00:00			`(cd frontend && 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
			`lunchy start postgres`

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`
			`rake db:fixtures:load`
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!`