Remote R: Control a Remote R Session from a Local One

A set of utilities for client/server computing with R, controlling a remote R session (the server) from a local one (the client). Simply set up a server (see package vignette for more details) and connect to it from your local R session ('RStudio', terminal, etc). The client/server framework is a custom 'REPL' and runs entirely in your R session without the need for installing a custom environment on your system. Network communication is handled by the 'ZeroMQ' library by way of the 'pbdZMQ' package.


Control a remote R session from your local R session. The package uses pbdZMQ to handle the communication and networking. Encryption is supported if the sodium package is (optionally) installed. Details below.

Installation

You can install the stable version from CRAN using the usual install.packages():

install.packages("remoter")

In order to be able to create and connect to secure servers, you need to also install the sodium package. The use of sodium is optional because it is a non-trivial systems dependency, but it is highly recommended. You can install it manually with a call to install.packages("sodium") or by installing remoter via:

install.packages("remoter", dependencies=TRUE)

The development version is maintained on GitHub, and can easily be installed by any of the packages that offer installations from GitHub:

### Pick your preference
devtools::install_github("RBigData/remoter")
ghit::install_github("RBigData/remoter")
remotes::install_github("RBigData/remoter")

To simplify installations on cloud systems, we also have a Docker container available.

Usage

For setting up a local server, you can do:

remoter::server()

And connect to it interactively via:

remoter::client()

There is also the option to pipe commands to the server in batch using the batch() function:

### Passing an R script file
remoter::batch(file="my_rscript_file.r")
### Passing in a script manually
remoter::batch(script="1+1")

For more details, including working with remote machines, see the package vignette.

Acknowledgements

Work for the remoter package was supported in part by the project Harnessing Scalable Libraries for Statistical Computing on Modern Architectures and Bringing Statistics to Large Scale Computing funded by the National Science Foundation Division of Mathematical Sciences under Grant No. 1418195.

Any opinions, findings, and conclusions or recommendations expressed in this material are those of the authors and do not necessarily reflect the views of the National Science Foundation.

News

Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.

install.packages("remoter")

0.4-0 by Drew Schmidt, 2 months ago


https://github.com/RBigData/remoter


Report a bug at https://github.com/RBigData/remoter/issues


Browse source code at https://github.com/cran/remoter


Authors: Drew Schmidt [aut, cre], Wei-Chen Chen [aut], R Core team [ctb] (some functions are modified from the R source code)


Documentation:   PDF Manual  


BSD 2-clause License + file LICENSE license


Imports pbdZMQ, getPass, argon2, stats, utils, tools, grDevices, graphics, png

Suggests sodium, pbdRPC


Enhanced by pbdRPC.


See at CRAN