Skip to main content
In this tutorial, you:
  • Create a project and set it up for App publishing
  • Publish a simple two file Shiny App to make it globally discoverable
  • Observe how other users in Domino can use the App
You’ll be working with the Telephones by region example from the Shiny gallery. In this example, the application serves an interactive bar chart of consumer telephones by region from 1951 to 1961. It takes approximately 10 minutes to get this example running in Domino.

Set up the Project

The first step is creating a project with the settings and content you need to publish your App.
  1. From the home page, click Develop > Projects.
  2. Click New Project.
  3. Give your project an informative name, choose the Private visibility setting, then click Create Project.
  4. Click Settings in the project sidebar, then set the Compute environment to Domino Standard Environment Py3.8 R4.1. Read Domino standard environments to learn more about the contents of this base image.
  5. Click Code in the project sidebar, then click Add File.
  6. Name the file server.R in the title field above the editor. It’s important that the file be named exactly this, as launching Shiny application with two files, requires a directory to contain files named server.R and ui.R.
  7. In the body of the file, paste the following example Shiny server code.
  8. Click Save when finished.
  9. Click Add File again, and name the new file ui.R.
  10. Paste in the following content, then click Save when finished.
  11. The last thing to do before publishing your App is to create an app.R file. This is a script that Domino runs after initializing the host that serves your App. It should contain all commands required to launch your App. In this example, the only command you need is:
    The host and port parameters control where Domino directs App traffic. Apps published in Domino must use host 0.0.0.0 and port 8888. Create the app.R file the same way you created server.R and ui.R, then save it.

Publish and deploy the App

Creating an App no longer deploys it. Preview the App in a workspace, publish a version, then deploy that version. Select app.R as your App file.
1

Create the App

On your project’s Deploy > Apps & Agents page, select Create, then App in Workspace. Any workspace you already have open works too. See Create an App.
2

Preview it

In the workspace, open the App Preview tab and set the App file, Compute Environment, and Hardware Tier. Commit your code first, because preview runs the latest committed code. See Develop and test an App.
3

Publish a version

Select Publish App, then Publish as a new App. This records an immutable version and doesn’t start it.
4

Deploy the version

On the App details page, select the version and select Deploy, then set access under Access and sharing. See Publish and deploy App versions and Share an App.
Set Permissions to Anyone in Domino to let any user with a Domino account open the App from its URL. Once the App status says Running, select View App to load it. You should see the interactive bar chart with a Domino toolbar above it showing the Project it’s published from, plus buttons to email the App owner and open the description panel.

Scale a Shiny App

Shiny is single-threaded, so autoscale horizontally with session affinity enabled. See R/Shiny autoscaling guidance for recommended settings.

Share and consume

Use Anyone in Domino to share the App with colleagues who have Domino accounts. To test broad access, select Deployments > App > Copy App Link, then open the link while signed in as a Domino user who isn’t a Project collaborator. To browse more apps, click Deploy > Apps in the top navigation menu.
Last modified on September 3, 2026