scalra/INSTALL.md

node.js framework to prototype and scale rapidly

# Installation Guide
Step-by-step instructions to setup a Scalra system from scratch on a Ubuntu System
(you may skip steps if they're already performed on your local system)
	
## Environment

1. Install [node.js](https://nodejs.org) LTS (4.5.0)
```sudo apt-get install node```

2. Install [MongoDB](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/)
or type	```sudo apt install mongodb```
 
## Setup DB Admin Password
MongoDB by default does not have an admin account, but it is better for security measures.
This also allows Scalra to create DB on the fly for you.

1. Install Mongo client
```sudo apt-get install mongodb-clients```  

2. Setup MongoDB admin account 
`$mongo`

then type:
```
use admin
db.createUser(
  {
    user: "dbadmin",
    pwd: "dbadmin-pass",
    roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
  }
)
```

note: please change user / pwd to your preferred DB admin account and password (need to match /settings.js)


## Setup Project Repo

1. clone the project's git repo
```git clone https://github.com/your_org/your_project.git```

2. create local copy of settings.js
```cd your_project; cp settings.js.example settings.js```

3. install required libs
```npm install```

4. (optional) setup SSH keys
If you need to run HTTPS services, make sure you've put the correct & relevant files under the /keys directory, for example:
```
	keys: {
		privatekey: __dirname + '/keys/privatekey.pem',
		certificate: __dirname + '/keys/certificate.pem'
	}	
```	
or point to specific directories where the key files exist. For example:
	
```
	keys: {
		privatekey: '/etc/letsencrypt/live/privkey.pem',
		certificate: '/etc/letsencrypt/live/fullchain.pem'		
	}	
```			
	
## Start Server and Test

```npm start```