# RStudio Kubernetes

Generated on 9 Feb 2022 from [the RStudio Kubernetes catalog page](https://marketplace.digitalocean.com/apps/rstudio-kubernetes)

RStudio Server is the premier integrated development environment for R that allows to move computation close to the data and scale compute and RAM centrally.

This is a pre-configured image with R and the open source edition of RStudio Server. The particular setup for this software uses the RStudio image from the Rocker project (Docker for R users).

## Software Included

| Package | Version | License |
|---|---|---|
| R | [4.1.0](https://cran.r-project.org/) | [GPL-3](https://www.r-project.org/Licenses/AGPL-3) |
| RStudio Server | [2021.09.2+382](https://www.rstudio.com/products/rstudio/release-notes/) | [AGPL-3](http://www.gnu.org/licenses/agpl-3.0-standalone.html) |
| Rocker Tidyverse | [4.1.0](https://hub.docker.com/r/rocker/rstudio) | [GPL-2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) |

## Creating an App using the Control Panel

Click the **Deploy to DigitalOcean** button to install a Kubernetes 1-Click Application. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

[![Deploy to DO](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/kubernetes/clusters/new?addonslug=rstudio&nodePools=s-1vcpu-2gb%3A3)

## Creating an App using the API

In addition to creating RStudio Kubernetes using the control panel, you can also use the [DigitalOcean API](https://docs.digitalocean.com/reference/api). As an example, to create a 3 node DigitalOcean Kubernetes cluster made up of Basic Droplets in the SFO2 region, you can use the following `doctl` command. You need to authenticate with `doctl` with your [API access token](https://docs.digitalocean.com/reference/api/create-personal-access-token/index.html.md) and replace the `$CLUSTER_NAME` variable with the chosen name for your cluster in the command below.

```shell
doctl kubernetes clusters create --size s-4vcpu-8gb $CLUSTER_NAME --1-clicks rstudio
```

## Getting Started After Deploying RStudio Kubernetes

Once you deploy this 1-click Kubernetes listing, verify that RStudio Server is running with `kubectl get pods -A`. You should see a line similar to `rstudio rstudio-12345-67890 1/1 Running 0 99s`.

Forward port 8787 with `kubectl -n rstudio port-forward deploy/rstudio 8787`.

Log in to RStudio by visiting `localhost:8787`. This Kubernetes instance uses *rstudio* for both user and password, to change that type `passwd rstudio` in RStudio’s terminal.

Now you are ready to use RStudio Kubernetes!

*Note: It is recommended a minimum of 2 nodes is required to prevent downtime during upgrades or maintenance.*