# Shiny Kubernetes

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

Shiny Server makes it easy to build interactive web apps straight from R. You can host standalone apps on a webpage or embed them in R Markdown documents or build dashboards. You can also extend your Shiny apps with CSS themes, htmlwidgets, and JavaScript actions.

This is a pre-configured image with R and the open source edition of Shiny Server. The particular setup for this software uses the Shiny 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) |
| Shiny | [1.5.17.973](https://github.com/rstudio/shiny-server/blob/master/NEWS) | [GPL-3](http://www.gnu.org/licenses/agpl-3.0-standalone.html) |
| Rocker Shinyverse | [4.1.0](https://hub.docker.com/r/rocker/shiny-verse) | [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=shiny&nodePools=s-1vcpu-2gb%3A3)

## Creating an App using the API

In addition to creating Shiny 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 shiny
```

## Getting Started After Deploying Shiny 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 `shiny shiny-12345-67890 1/1 Running 0 99s`.

Forward port 3838 with `kubectl -n shiny port-forward deploy/shiny 3838`.

Visit `localhost:3838` and you are ready to use Shiny Kubernetes!

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