metamaps--metamaps/doc/WindowsInstallation.md

62 lines
2.3 KiB
Markdown
Raw Permalink Normal View History

2017-07-26 16:25:41 +00:00
DISCLAIMER: This tutorial is liable to be out of date, and we don't necessarily support Windows development. If you are set on installing Metamaps on Windows, it may be worthwhile to look at the Mac and Ubuntu docs for up to date information on what Metamaps requires to run.
2017-07-25 23:44:40 +00:00
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
2017-07-26 16:25:41 +00:00
rake db:seed
2014-09-03 15:38:43 +00:00
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!