For detailed requirements and install instructions see irkernel.github.io
We will soon submit the IRkernel package to CRAN. Until then, you can install it via the
install.packages(c('repr', 'IRdisplay', 'crayon', 'pbdZMQ', 'devtools')) devtools::install_github('IRkernel/IRkernel') IRkernel::installspec() # to register the kernel in the current R installation
IRkernel::installspec() will install a kernel with the name “ir” and a
display name of “R”. Multiple calls will overwrite the kernel with a kernel spec pointing to the last
R interpreter you called that commands from. You can install kernels for multiple versions of R
by supplying a
displayname argument to the
installspec() call (You still need to
install these packages in all interpreters you want to run as a jupyter kernel!):
# in R 3.3 IRkernel::installspec(name = 'ir33', displayname = 'R 3.3') # in R 3.2 IRkernel::installspec(name = 'ir32', displayname = 'R 3.2')
Now both R versions are available as an R kernel in the notebook.
If you encounter problems during installation
- Have a look at the full installation instructions!
- Search the existing open and closed issues.
- If you are sure that this is a new problem, file an issue.
Running the notebook
If you have Jupyter installed, you can create a notebook using IRkernel from the dropdown menu.
You can also start other interfaces with an R kernel:
# “ir” is the kernel name installed by the above `IRkernel::installspec()` # change if you used a different name! jupyter qtconsole --kernel=ir jupyter console --kernel=ir
Run a stable release in a Docker container
Refer to the jupyter/docker-stacks r-notebook repository
If you have a Docker daemon running, e.g. reachable on localhost, start a container with:
docker run -d -p 8888:8888 jupyter/r-notebook
In your browser open the URL http://localhost:8888/. All notebooks from your session will be saved in the current directory.
On other platforms without docker, this can be started using
docker-machine by replacing “localhost” with an IP from
docker-machine ip <MACHINE>. With the deprecated
boot2docker, this IP will be
Develop and run from source in a Docker container
make docker_dev_image #builds dev image and installs IRkernel dependencies from github make docker_dev #mounts source, installs, and runs Jupyter notebook; docker_dev_image is a prerequisite make docker_test #builds the package from source then runs the tests via R CMD check; docker_dev_image is a prerequisite