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.


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


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

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


For setting up a local server, you can do:


And connect to it interactively via:


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

### Passing an R script file
### Passing in a script manually

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


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.


Reference manual

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


0.4-0 by Drew Schmidt, 5 months ago

Report a bug at

Browse source code at

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