X-Git-Url: https://gerrit.onap.org/r/gitweb?p=ccsdk%2Fdistribution.git;a=blobdiff_plain;f=dgbuilder%2FINSTALL.md;fp=dgbuilder%2FINSTALL.md;h=90922e6f428e25fe19fb36bcc9badf2496119c52;hp=0000000000000000000000000000000000000000;hb=d1569975bb18f4359fac18aa98f55b69c248a3ad;hpb=a016ea661ff5767a3539734c4c07ef974a6e4614 diff --git a/dgbuilder/INSTALL.md b/dgbuilder/INSTALL.md new file mode 100644 index 00000000..90922e6f --- /dev/null +++ b/dgbuilder/INSTALL.md @@ -0,0 +1,57 @@ +Node-RED Install +================ + +## Install node.js + +You can get the latest version from . + +Or, you may want to use a version from your operating system's package manager: + + +## Get Node-RED + +Clone the repository from GitHub: + + $ git clone git@github.com:node-red/node-red.git + +## Install the pre-requisite modules + +From the top-level directory of Node-RED, run: + + $ npm install + +This will install the core pre-requisite modules. + +## Run Node-RED + +From the top-level directory, run: + + $ node red.js + +You can then access Node-RED at . + +Online documentation is available at . + +## Installing individual node dependencies + +When Node-RED starts, it attempts to load the nodes from the `nodes/` directory. +Each will have its own set of dependencies that will need to be installed before +the node is available in the palette. + +To help identify the dependencies, Node-RED logs any modules it fails to find +for a particular node. You don't have to install these unless you want or need +that node to appear. + +Alternatively, a node's `.js` file can be examined to identify the modules it +explicitly requires. For example, the Twitter node is defined in +`nodes/social/27-twitter.js` and contains: + + var RED = require("../../red/red"); + var ntwitter = require('ntwitter'); + var OAuth= require('oauth').OAuth; + +Of these, `ntwitter` and `oauth` are neither built-in modules nor ones provided +by Node-RED itself. They can subsequently be installed by running: + + $ npm install ntwitter oauth +