- How do I publish an App?
- How do I view my App?
- Who can see my App?
- Where do I find Apps in Domino?
When experiments in Domino yield interesting results that you want to share with your colleagues, you can easily do so with a Domino App. Domino Apps host web applications and dashboards with the same elastic infrastructure that powers runs and workspaces. Domino supports hosting apps built with many popular frameworks, including Flash, Shiny, and Dash. Apps are first-class objects in Domino, and Domino includes features that allow for easy sharing, monitoring, collaborating, and iterating on Apps.
Apps are published from Domino projects. To publish an App, you need to:
- Have all of your application code in the project files for the project you want to publish from, or loaded into your project from an external git repository.
- Configure your application to serve from a host address of 0.0.0.0 on port 8888. This is the host and port Domino will use when directing users to your application server.
- Have an app.sh file in the project. Domino will look for and execute a shell script named app.sh after creating the hardware that will host your App. Put all commands required to launch your application in app.sh.
When your application code is ready for publishing, and you've set up app.sh, click Publish from the project sidebar. Give your App an informative name and description, choose a permissions setting, and toggle the Show in Launchpad checkbox to control whether your App appears in the Domino Launchpad. Click Publish when you're finished setting up the basics of your App.
You will then be directed to the App settings interface, where you can choose the Hardware Tier your App will run on, change the name and description of the App, control permissions, and monitor usage of the App.
For complete end-to-end examples of App publishing, check out these tutorials:
Remember these key facts about App publishing in Domino:
- Your App will run on the same Domino execution hardware your project uses normally. Make sure your Domino Environment has all of the dependencies your application requires.
- Your application must be configured to serve from a host address of 0.0.0.0 on port 8888.
- The performance of your Domino App will depend on the design of the underlying application. Read more about designing Flask and Shiny applications for performance.
The App settings page has a View App button that can be used to open your App while it is running. You can also copy a persistent App URL from the App settings page that can be used to access and share your App.
You can also see all of your own Apps from the Domino Launchpad.
Project owners, contributors, and results consumers automatically have access to an App. To control more general access to an App, use the Permissions tab on the App settings page.
Under Access Permissions are the following four options:
- Anyone, including anonymous users
Any request to the App URL will be served the App. This setting means that anyone with network access to Domino can view your App. This is useful for sharing Apps with people on your network who do not have Domino accounts.
- Anyone with an account
All users who have Domino accounts and are logged in to Domino can view your App.
- Invited users (other users may request access)
All users who have Domino accounts and are logged in to Domino can request access to your App if it appears in the Launchpad, but cannot view the App until the owner grants the request.
- Invited users only
Only Domino users who are added by the App owner via the Invite People field can view the App. Users cannot request access.
Use the Invite People field to send email invites. Domino users who receive an invite will be able to access the App. Users who request access will appear in the Who has access table, and can be granted or denied from controls in the Status column.
All Apps that are configured to Show in Launchpad will appear in the Domino Launchpad:
This is the primary interface for Domino users who want to consume Apps. You can click on an App in this list to see its description, settings, recent usage, and a link to either view the app or request access.
When viewing an App in Domino, App consumers have access to a toolbar with controls to view the App description, and to contact the App owner.