Installation Guide

Note: This is still a work in progress and should be considered incomplete. Suggestions, requests, etc, are welcome.

Preinstallation

Installing dependencies

The following dependencies are required. However, it is worth noting that the following items do not need to reside on the same machine

• NodeJS v4.1.1
• MongoDB v3.0.7

Installation

MongoDB

Download and install from the website. If you are planning on running MongoDB locally on the same machine as DeepForge, simply start mongod and continue to setting up DeepForge.

If you are planning on running MongoDB remotely, set the environment variable "MONGO_URI" to the URI of the Mongo instance that DeepForge will be using:

MONGO_URI="mongodb://pathToMyMongo.com:27017/myCollection" npm start

DeepForge Server

First, clone the repository:

git clone https://github.com/dfst/deepforge.git

Then install the project dependencies:

npm install

To run all executions locally start with npm run local and navigate to http://localhost:8080 to start using DeepForge!

Alternatively, run npm start locally and navigate to http://localhost:8080 if jobs are going to be executed on a client.

DeepForge Clients

There is no need to start a client if you use npm run local. This starts a local client for you!

To connect a client to execute jobs, start a worker with npm run worker on the client (make sure Torch7 and project packages are installed on the client!!).