metamaps--metamaps/doc/WindowsInstallation.md

60 lines
2 KiB
Markdown
Raw Permalink Normal View History

2015-11-23 01:54:36 +00:00
Before you begin, you'll need to install stuff:
2014-09-03 15:38:43 +00:00
2015-11-23 01:54:36 +00:00
Ruby, Git, and Rails: http://railsinstaller.org/en
PostgreSQL 9.2: http://www.enterprisedb.com/products-services-training/pgdownload
nodejs: http://nodejs.org/download
2016-01-17 02:17:02 +00:00
During the installation of the PostgreSQL database, you'll need to choose a
database password. Anything is fine, just note down what you choose.
2014-09-03 15:38:43 +00:00
2016-01-17 02:17:02 +00:00
Once you are ready, create a new folder to hold this and any other git
repositories. As an example, let's pretend you've chose C:\git, and made that
folder writable by your user account.
2014-09-03 15:38:43 +00:00
2015-11-03 11:10:21 +00:00
Now you are ready to clone the Metamaps git repository:
2014-09-03 15:38:43 +00:00
2016-04-13 02:16:54 +00:00
git clone https://github.com/metamaps/metamaps.git --branch develop
cd metamaps
2014-09-03 15:38:43 +00:00
bundle install
2016-01-17 02:17:02 +00:00
The third `bundle install` command downloads and installs the rubygem
dependencies of Metamaps.
2015-12-22 18:16:03 +00:00
You also need to install the ES6 code from the nodejs repositories:
npm install
npm run build
2016-04-13 02:16:54 +00:00
At this point you should be in C:\git\metamaps, or whatever equivalent
2016-01-17 02:17:02 +00:00
directory you've chosen. The next step is to set up your database
2016-04-13 02:16:54 +00:00
configuration. From the metamaps directory, run
2015-11-03 11:10:21 +00:00
start config
2014-09-03 15:38:43 +00:00
2016-01-17 02:17:02 +00:00
This command will open a Windows Explorer window of the "config" directory of
Metamaps. Copy `.example-env`, and rename the copy to `.env`. Edit the file and
set the DB_PASSWORD to be whatever you set up with postgres earlier. Once
you're done, then move back into the command prompt. The next few commands will
fail unless `.env` is correctly configured and Postgres is running.
2014-09-03 15:38:43 +00:00
rake db:create
rake db:schema:load
rake db:fixtures:load
2016-01-17 02:17:02 +00:00
And you're set up! At this point, you should be able to run the server at any
time with only one command; you don't need to repeat any of the previous steps
again. The command to run the server is:
2014-09-03 15:38:43 +00:00
rails s
2015-12-22 18:16:03 +00:00
2014-09-03 15:38:43 +00:00
Navigate your browser to localhost:3000 once you have the server running
Sign in with the default account
2015-11-23 01:54:36 +00:00
email: user@user.com
password: toolsplusconsciousness
2014-09-03 15:38:43 +00:00
2014-09-03 15:40:35 +00:00
OR create a new account at /join, and use access code 'qwertyui'
2014-09-03 15:38:43 +00:00
Start mapping and programming!