runApp
runApp(appDir = getwd(), port = NULL,
launch.browser = getOption("shiny.launch.browser", interactive()),
host = getOption("shiny.host", "127.0.0.1"), workerId = "",
quiet = FALSE, display.mode = c("auto", "normal", "showcase"))
Arguments
appDir | The directory of the application. Should contain
server.R , plus, either ui.R or a www directory that
contains the file index.html . Defaults to the working directory.
Instead of a directory, this could be a list with ui and
server components, or a Shiny app object created by
shinyApp . |
---|---|
port | The TCP port that the application should listen on. Defaults to choosing a random port. |
launch.browser | If true, the system's default web browser will be launched automatically after the app is started. Defaults to true in interactive sessions only. This value of this parameter can also be a function to call with the application's URL. |
host | The IPv4 address that the application should listen on. Defaults
to the shiny.host option, if set, or "127.0.0.1" if not. See
Details. |
workerId | Can generally be ignored. Exists to help some editions of Shiny Server Pro route requests to the correct process. |
quiet | Should Shiny status messages be shown? Defaults to FALSE. |
display.mode | The mode in which to display the application. If set to
the value "showcase" , shows application code and metadata from a
DESCRIPTION file in the application directory alongside the
application. If set to "normal" , displays the application normally.
Defaults to "auto" , which displays the application in the mode given
in its DESCRIPTION file, if any. |
Description
Runs a Shiny application. This function normally does not return; interrupt R to stop the application (usually by pressing Ctrl+C or Esc).
Details
The host parameter was introduced in Shiny 0.9.0. Its default value of
"127.0.0.1"
means that, contrary to previous versions of Shiny, only
the current machine can access locally hosted Shiny apps. To allow other
clients to connect, use the value "0.0.0.0"
instead (which was the
value that was hard-coded into Shiny in 0.8.0 and earlier).
Examples
## Not run: ------------------------------------
# # Start app in the current working directory
# runApp()
#
# # Start app in a subdirectory called myapp
# runApp("myapp")
## ---------------------------------------------
## Not run: ------------------------------------
# # Apps can be run without a server.r and ui.r file
# runApp(list(
# ui = bootstrapPage(
# numericInput('n', 'Number of obs', 100),
# plotOutput('plot')
# ),
# server = function(input, output) {
# output$plot <- renderPlot({ hist(runif(input$n)) })
# }
# ))
#
#
# # Running a Shiny app object
# app <- shinyApp(
# ui = bootstrapPage(
# numericInput('n', 'Number of obs', 100),
# plotOutput('plot')
# ),
# server = function(input, output) {
# output$plot <- renderPlot({ hist(runif(input$n)) })
# }
# )
#
# runApp(app)
## ---------------------------------------------