Run Launchers

Tired of other people asking you to re-run your analysis?
Domino lets you build web forms so they can do it themselves!

A Run Launcher is a web-based form that your collaborators can use to run your scripts through the Domino web site, without using the command line, and without knowing anything about your code. You can even define which parameters the user must provide. Here's an example of a Launcher UI:

Creating your own Run Launchers

To create new Launchers (or manage ones you already have), click on the Launchers tab of your project.

Create a Launcher by specifying the following values:

  • Name: The human-readable name for your launcher. This is how your collaborators will identify your Launcher.
  • Command: The command that this launcher will ultimately run. This will be hidden from the users who uses your Launcher. You can use ${} to declare parameters to be filled in at run time.
    For example, "runAnalysis.py ${param1} -f ${outFile}" defines two parameters: "param1" and "outfile".
  • Parameters: Each parameter can be either a text field, a drop-down menu of predefined choices, or a file upload. "File upload" parameters will prompt the user to upload a file; the uploaded file will be added in the root of your project folder, and the file name will be passed into your script.

Starting a run from Launcher

Your collaborators can select any of your Launchers from the "Launchers" button on the Runs Dashboard. Or you can send them a link to your Launcher. That Launcher page will present the rendered form, with prompts for any of your parameters. When your collaborator clicks "Start run", the "Command" will be filled in with the specified parameter values, and a new run will launch. The user will then be taken directly to the Run Console for the new run, so they can monitor progress.


If this article is incorrect, confusing, out of date, or unhelpful, please don't hesitate to contact us. We'll do our best to help you.