This image is based on official rocker/tidyverse image. It adds a few feature, such as:
- sparklyr: Connect to Spark from R
- Saagie Add-in: allows you to push R jobs to Saagie's platform
- Ability to create multiple users accounts
Simply run:
docker run --rm -it -p8787:8787 -v $PWD/rstudio:/home --name rstudio saagie/rstudio:latest
Then you'll be able to access RStudio at http://localhost:8787 using the default user (login: rstudio, password: rstudio).
Mounting a volume to /home directory allows you to persist every RStudio user projects and settings. Meaning the -v $PWD/rstudio:/home part is optional but can be useful.
By default, the only user able to run sudo commands is admin, but you can also allow it for rstudio user by running the container with -e ROOT=TRUE option.
If you want to use sparklyr you'll need to mount a few volumes to share your cluster configuration with your container.
In this case, try something like:
docker run --rm -it -p8787:8787 -v $PWD/rstudio:/home -v $PWD/hadoop/conf:/etc/hadoop/conf --name rstudio saagie/rstudio:latest
And you may also need to run it in HOST mode (for example if you're using a VPN).
If you want to run RStudio on a custom port, let's say port 9999, you can run it like:
- Bridge mode:
docker run --rm -it -p9999:9999 --name rstudio saagie/rstudio:latest /init_rstudio.sh --port 9999 - Host mode:
docker run --rm -it --net=host --name rstudio saagie/rstudio:latest /init_rstudio.sh --port 9999
If you want to create new RStudio users, you'll need to log in to RStudio as: admin (password: rstudioadmin).
Then go to 'Tools > Shell' and run sudo adduser my_new_user.
You'll be prompted to enter admin's password, and then to chose your new user's password. No need to fill in the other fields.
If you want to allow this new user to install libraries, you need to add him to the staff group using the following command: sudo adduser my_new_user staff.
Important note: After you created a new user, remember to run ./backupusers. This will backup users info in a tarball. If you add mounted a volume to /home, every user will be recreated on next container startup.