Skip to content


Subversion checkout URL

You can clone with
Download ZIP
RCloud is an HTML5 frontend for collaboratively developing and sharing R scripts
JavaScript R CSS Python Shell PHP Other
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Getting it to work

Installation requirements


You'll need a recent version of Rserve. From R, type:

> install.packages("Rserve",,"")

You'll need the following packages from CRAN:

  • Cairo
  • FastRWeb
  • png
  • knitr
  • markdown
  • base64enc
  • rjson

You'll need the following packages from github (Installing via devtools is the easiest):

> library(devtools) # or install.packages("devtools")
> install_github("hadley", "httr")
> install_github("cscheid", "github")

Github authentication

Rcloud uses gists for storage and Github accounts for authentication.

You'll need to create a github application. This github application will need to point to the location you will deploy rcloud (let's assume you're only testing it for now, so works). In that case, your application's URL will most likely be, and your Callback URL must be (the host and port needs to match the URL, and the path must be login_successful.R).

Then, you need to create a file under your configuration root (typically that's /conf) called github_info.txt. This file will contain the information necessary to connect to the github website and API. If you're using, then your file will look like this:

The third and fourth lines are the base URL of the github website and the entry point for the github API (these might differ in Enterprise Github deployments).

Will you be hacking on the code? Read on

If you're just running rcloud, skip this session. If you're going to be hacking the code, you'll need to install a recent version of node.js. Then, in your shell:

$ cd rcloud/htdocs/js
$ npm install

This will install the node.js dependencies necessary to create the minified javascript files used in Rcloud.

Starting rcloud

The safest way to install rcloud currently is to simply run the scripts/ script. This will reinstall the package, recompile the javascript files (if you have node.js and the necessary dependencies installed), kill any old instances of Rcloud running, deauthorize all login tokens, and start a new version of Rcloud.

FIXME: currently actually kills all Rserve instances via killall. Yes, this is blunt and stupid.

Something went wrong with that request. Please try again.