Installing RAIN

In this document you will find all the information needed to setup RAIN for development.

Installing node.js & npm

RAIN runs on the node.js platform. Installing this platform is the first step to developing with RAIN. NPM is also needed for package management.

Ubuntu Linux

sudo apt-get install python-software-properties
sudo apt-add-repository ppa:chris-lea/node.js
sudo apt-get update
sudo apt-get install nodejs npm


Download and run the official installer from

Other Operating Systems / Distributions

Follow the official node.js wiki at and locate the steps for your operating system / distribution.

Building from source

Follow the official node.js wiki at


Installing the RAIN SDK is the easiest way to start developing a new project with RAIN. After the installation is done, go ahead and read the RAIN SDK Tutorial to start developing!

Linux / Unix / Mac OS

sudo npm install -g node-gyp
sudo npm install -g rain


Running NPM on Windows to install the RAIN package only works from a MinGW bash prompt. You can get a MinGW bash installation from two places:

Inside a bash prompt, you then need to run:

npm install -g rain

RAIN from source

This is the way to go if you want to contribute to this project. To get started with this you need to execute the following commands:

Linux / Unix / Mac OS

sudo apt-get install git
git clone
cd rainjs
sudo npm install -g node-gyp
sudo npm link


You first need to install git. You have two equally excellent options:

Inside a bash prompt, you then need to run:

npm link

Running RAIN

Inside the project working directory, running the raind command will start the server. Accessing http://localhost:1337/example/index will load the example component that comes with the project’s sources.


[1]Using GitHub for Windows requires a GitHub account