Host Shiny applications over the web.
JavaScript HTML Shell Ruby C++ R Other
Clone or download
jcheng5 Merge pull request #374 from rstudio/joe/bugfix/edge-xhr-streaming
Use newer build of shiny-server-client
Latest commit 0151159 Aug 13, 2018
Permalink
Failed to load latest commit information.
R Set up logging earlier in R subprocess Jul 17, 2017
assets Use universal shiny-server-client instead of shiny-server.js Mar 10, 2016
bin support systemd Jun 18, 2015
config Merge pull request #362 from rstudio/joe/bugfix/log-as-user May 18, 2018
docker Remove ubuntu-12.04 build environment Mar 9, 2018
external Upgrade to Node v8.11.3 (#367) Jun 20, 2018
lib Exit code should be nonzero in case of error Jun 21, 2018
manual.test Catch unhandled exceptions in loadtest-xhr Dec 10, 2013
packaging Shut down existing shiny-server before starting new one Mar 23, 2018
samples Updated paths to sample apps to include trailing slash. Oct 1, 2014
scripts Fix issues with log_as_user May 15, 2018
src Implement IPv6 listener support May 11, 2018
templates Use HTTPS for Google Fonts on error page Oct 23, 2017
test Merge pull request #362 from rstudio/joe/bugfix/log-as-user May 18, 2018
tools Remove unneeded dependency on regexp-quote Feb 28, 2018
vagrant Bring nfs vagrant setup up-to-date for SSO May 15, 2018
.gitignore Remove node_modules Jul 14, 2016
CMakeLists.txt Remove 'rh' from rpm filename, since this is for SuSE too Jul 26, 2018
COPYING Adding copyright Nov 26, 2012
Jenkinsfile fixed the path Mar 28, 2018
NEWS Fix typo in NEWS Jun 21, 2018
NOTICE.md Update open source license list for shiny-server-client Mar 21, 2016
README.md README link: shiny-discuss --> rstudio community Mar 8, 2018
binding.gyp Smaller API for running/monitoring workers Dec 14, 2012
config.html Regenerate config doc. Jul 13, 2015
npm-shrinkwrap.json Use newer build of shiny-server-client Aug 11, 2018
package.json Use newer build of shiny-server-client Aug 11, 2018
upstream.txt No upstream branch for shiny-server/master Oct 19, 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 Community discussion board. If you're interested in Professional Support, please look at our commercial Shiny Server Pro product.