Run a Docker container with a Shiny application

Run a Docker container with a Shiny application

Usage

run_container(
  app_dir,
  tag = NULL,
  port = 3838,
  detach = FALSE,
  env_vars = NULL,
  docker_compose = TRUE,
  quiet = FALSE,
  force_port = FALSE,
  ...
)

Arguments

app_dir

Character. Path to the Shiny application directory with Docker configuration.

tag

Character. The tag for the Docker image to run. If NULL, a tag will be generated from the directory name (should match what was used in build_image).

port

Integer. The port to map to the container's exposed port. Default: 3838.

detach

Logical. If TRUE, run container in detached mode. Default: FALSE.

env_vars

Named character vector. Environment variables to pass to the container.

docker_compose

Logical. If TRUE, use docker-compose for running if available. Default: TRUE.

quiet

Logical. If TRUE, suppress Docker command output. Default: FALSE.

force_port

Logical. If TRUE, fail if requested port is unavailable. If FALSE, try to find an alternative port. Default: FALSE.

...

Additional arguments passed to processx.

Value

For detached mode, invisibly returns the container ID if successful. For attached mode, the function will block until the container stops.

Examples

if (FALSE) { # \dontrun{
# First create Docker configuration and build
dockerize("path/to/my/shinyapp")
build_image("path/to/my/shinyapp")

# Run the container
run_container("path/to/my/shinyapp")

# Run detached on a different port
run_container("path/to/my/shinyapp", port = 8080, detach = TRUE)
} # }