Host Shiny applications over the web.
JavaScript HTML Shell Ruby C++ R Other
Permalink
Failed to load latest commit information.
R Create each app's bookmark dir only when actually saving bookmark Sep 8, 2016
assets Use universal shiny-server-client instead of shiny-server.js Mar 10, 2016
bin support systemd Jun 18, 2015
config Implement support for bookmarkable state persistence Jun 14, 2016
docker Docker README edits Sep 8, 2016
external Upgrade to Node v0.10.46 Jul 14, 2016
lib Remove outdated comment Sep 21, 2016
manual.test Catch unhandled exceptions in loadtest-xhr Dec 10, 2013
packaging Create /var/lib/shiny-server on install. Closes #231 Aug 13, 2016
samples Updated paths to sample apps to include trailing slash. Oct 1, 2014
scripts Handle /log directory creation as the user. Nov 24, 2015
src Move node install to ./ext instead of ./bin Sep 9, 2013
templates Switch to HTTPS Mar 25, 2015
test Fix robust-sockjs tests Jul 18, 2016
tools Better memlog-view script--now uses Shiny Dec 10, 2013
vagrant got rid of some unnecessary, old print statements Apr 5, 2016
.gitignore Remove node_modules Jul 14, 2016
CMakeLists.txt Handle /log directory creation as the user. Nov 24, 2015
COPYING Adding copyright Nov 26, 2012
NEWS Update NEWS, bump version to 1.4.6 Sep 21, 2016
NOTICE.md Update open source license list for shiny-server-client Mar 21, 2016
README.md Tweaks to README Mar 14, 2016
binding.gyp Smaller API for running/monitoring workers Dec 14, 2012
config.html Regenerate config doc. Jul 13, 2015
npm-shrinkwrap.json Remove node_modules Jul 14, 2016
package.json Update NEWS, bump version to 1.4.6 Sep 21, 2016

README.md

Shiny Server

Shiny Server is a server program that makes Shiny applications available over the web.

Features

  • Host multiple Shiny applications, each with its own URL
  • Can be configured to allow any user on the system to create and deploy their own Shiny applications
  • Supports non-websocket-capable browsers, like IE9
  • Free and open source (AGPLv3 license)
  • Pre-built installers for select Linux distributions.

Installing

At this time, Shiny Server can be run on Linux servers with explicit support for Ubuntu 12.04 or greater (64 bit) and CentOS/RHEL 5 (64 bit) or greater. If you are using one of these distributions, please download the pre-packaged installers from RStudio:

Download Shiny Server Installers.

These installers will provide a majority of the prerequisite software and will provision all the necessary directories for you.

If you are not using one of the explicitly supported distributions, you can still use Shiny Server by building it from source, see the instructions for building from source.

Configuration

Shiny Server will use the default configuration unless an alternate configuration is provided at /etc/shiny-server/shiny-server.conf. Using the default configuration, Shiny Server will look for Shiny apps in /srv/shiny-server/ and host them on port 3838. If you plan to host your apps in this directory, you can either copy an app you've already developed to that location:

sudo cp -R ~/MY-APP /srv/shiny-server/

Or you can copy some or all of the examples provided with the Shiny package. (The location of the R library varies from system to system. You can use the command R -e ".libPaths()" --quiet to print the directory of the R library.) For instance, on Ubuntu, you could execute cp -R /usr/local/lib/R/site-library/shiny/examples/* /srv/shiny-server/.

Now start a web browser and point it to http://<hostname>:3838/APP_NAME/

If the browser is not able to connect to the server, configure your server's firewall to allow inbound TCP connections on port 3838.

To customize any of the above, or to explore the other ways Shiny Server can host Shiny apps, see the Shiny Server Configuration Reference for details on the various ways Shiny Server can be configured.

Documentation & Contact & Support

See the Administrator's Guide to Shiny Server for more complete documentation regarding the setup and management of Shiny Server.

Please direct questions to the shiny-discuss mailing list. If you're interested in Professional Support, please look at our commercial Shiny Server Pro product.