Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/flaviobarros/shiny-wordcloud

Example dockerized Shiny App
https://github.com/flaviobarros/shiny-wordcloud

docker r shiny

Last synced: about 1 month ago
JSON representation

Example dockerized Shiny App

Awesome Lists containing this project

README

        

[![Build Status](https://travis-ci.org/flaviobarros/shiny-wordcloud.svg?branch=master)](https://travis-ci.org/flaviobarros/shiny-wordcloud)
[![DOI](https://zenodo.org/badge/34694294.svg)](https://zenodo.org/badge/latestdoi/34694294)
[![](https://images.microbadger.com/badges/image/flaviobarros/shiny-wordcloud.svg)](https://microbadger.com/images/flaviobarros/shiny-wordcloud "Get your own image badge on microbadger.com")
[![](https://images.microbadger.com/badges/version/flaviobarros/shiny-wordcloud.svg)](https://microbadger.com/images/flaviobarros/shiny-wordcloud "Get your own version badge on microbadger.com")

Dockerized Shiny App
=======================

This is the Dockerized Shiny App [Wordcloud](http://shiny.rstudio.com/gallery/word-cloud.html)

This Dockerfile is based on Debian "testing" and r-base image.

The image is available from [Docker Hub](https://registry.hub.docker.com/u/flaviobarros/shiny-wordcloud/).

## Usage:

To run this Shiny App on your computer:

```sh
docker run --rm -p 80:80 flaviobarros/shiny-wordcloud
```

and it will avaliable at http://127.0.0.1/ or http://localhost

You can run the container at other ports. It can happen that there is some service running at PORT 80, as Apache ou Nginx.
To run the app at PORT 3838 for example, you can use:

```sh
docker run --rm -p 3838:80 flaviobarros/shiny-wordcloud
```

## Intented usage:

This project can be used as a start point to build any dockerized shiny app that could be distributed at any server running docker.
Possible use cases are:

* Deploy a single Shiny App at AWS, Google Compute Engine, Azure or a private server with docker.
* Deploy Shiny Apps at a docker based PaaS as [dokku](https://github.com/progrium/dokku).

## Building your own Shiny App:

After developing your Shiny App, you will need two files for deployment: ui.R and server.R. Then:

* Remove all files from folder mypp (these files are from Wordcloud example) and put your files there, ui.R and server.R
* Build a docker image with:

```sh
docker build -t yourname/yourappname .
```

At this poit you will be able to run your app, just like Wordcloud.

## Deploy with a docker based PaaS

If you have a PaaS with Dockerfiles support, like [Deis](http://deis.io/) or [Dokku](https://github.com/progrium/dokku), you can git push this image. I just wrote a post with further instructions: [Git pushing Shiny Apps with docker and dokku](https://www.rmining.com.br/2015/05/11/git-pushing-shiny-apps-with-docker-dokku/)

## Stargazers over time

[![Stargazers over time](https://starchart.cc/flaviobarros/shiny-wordcloud.svg)](https://starchart.cc/flaviobarros/shiny-wordcloud)

## IMPORTANT

This project is not an alternative Shiny Server. It exposes PORT 80 (not 3838) and is intented to serve only single shiny apps.