Shiny by RStudio

Sharing apps to run locally

Once you’ve written your Shiny app, you can distribute it for others to run on their own computers—they can download and run Shiny apps with a single R command. This requires that they have R and Shiny installed on their computers.

If you want your Shiny app to be accessible over the web, so that users only need a web browser, see

Here are some ways to deliver Shiny apps to run locally:


One easy way is to put your code on, a code pasteboard service from GitHub. Both server.R and ui.R must be included in the same gist, and you must use their proper filenames. See for an example.

Your recipient must have R and the Shiny package installed, and then running the app is as easy as entering the following command:


In place of '3239667' you will use your gist’s ID; or, you can use the entire URL of the gist (e.g. '').


  • Source code is easily visible by recipient (if desired)
  • Easy to run (for R users)
  • Easy to post and update


  • Code is published to a third-party server

GitHub repository

If your project is stored in a git repository on GitHub, then others can download and run your app directly. An example repository is at The following command will download and run the application:

shiny::runGitHub('shiny_example', 'rstudio')

In this example, the GitHub account is 'rstudio' and the repository is 'shiny_example'; you will need to replace them with your account and repository name.


  • Source code is easily visible by recipient (if desired)
  • Easy to run (for R users)
  • Very easy to update if you already use GitHub for your project
  • Git-savvy users can clone and fork your repository


  • Developer must know how to use git and GitHub
  • Code is hosted by a third-party server

Zip File, delivered over the web

If you store a zip or tar file of your project on a web or FTP server, users can download and run it with a command like this:


The URL in this case is a zip file that happens to be stored on GitHub; replace it with the URL to your zip file.


  • Only requires a web server for delivery


  • To view the source, recipient must first download and unzip it

Zip File, copied to recipient’s computer

Another way is to simply zip up your project directory and send it to your recipient(s), where they can unzip the file and run it the same way you do (shiny::runApp).


  • Share apps using e-mail, USB flash drive, or any other way you can transfer a file


  • Updates to app must be sent manually


If your Shiny app is useful to a broader audience, it might be worth the effort to turn it into an R package. Put your Shiny application directory under the package’s inst directory, then create and export a function that contains something like this:

shiny::runApp(system.file('appdir', package='packagename'))

where appdir is the name of your app’s subdirectory in inst, and packagename is the name of your package.


  • Publishable on CRAN
  • Easy to run (for R users)


  • More work to set up
  • Source code is visible by recipient (if not desired)

We love it when R users help each other, but RStudio does not monitor or answer the comments in this thread. If you'd like to get specific help, we recommend the Shiny Discussion Forum for in depth discussion of Shiny related questions and How to get help for a list of the best ways to get help with R code.

comments powered by Disqus