Getting it to work
You'll need a recent version of Rserve. From R, type:
You'll need the following packages from CRAN:
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")
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 127.0.0.1
works). In that case, your application's URL will most likely be
http://127.0.0.1:8080, and your Callback URL must be
http://127.0.0.1:8080/login_successful.R. (the host and port needs
to match the URL, and the path must be
Then, you need to create a file under your configuration root
/conf) called github_info.txt. This file will
contain the information necessary to connect to the github website and
API. If you're using github.com, then your file will look like this:
your.20.character.client.id your.40.character.client.secret https://github.com/ https://api.github.com/
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
The safest way to install rcloud currently is to simply run the
scripts/fresh_start.sh script. This will reinstall the
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.
fresh_start.sh actually kills all Rserve instances
via killall. Yes, this is blunt and stupid.