Dockstore 1.19 Release Announcement

Overview

We are pleased to announce the release of Dockstore 1.19, deployed on January 29, 2026.

This release is primarily focused on expanding the visibility of workflow metrics throughout the user interface, making it easier for users to discover which workflows are most actively used and to evaluate resource requirements before running them.

Search Interface Improvements

New Fields on Search Cards

Each search result card now displays two new fields:

Executions (new) — The total number of workflow executions reported across all integrated platforms, summed across all versions of the workflow. This gives you an at-a-glance sense of how widely a workflow is being used in practice.

Execution History Graph (new) — A small graph showing monthly execution counts over the past twelve months. This lets you see not just how popular a workflow is overall, but whether that usage is recent and active. Note that a workflow with high historical usage but little recent activity may show a sparse or nearly empty graph — this can be a useful signal when evaluating workflows for your own use.

Updates to the “Sort By” Menu

Two changes have been made to the search sort options:

Relevance (updated) — The relevance ranking algorithm has been updated to incorporate multiple signals, including search term frequency (when a search term is present), total execution count across all reported runs, the number of stars a workflow has received, when the workflow was last updated, and whether the workflow has been archived by its maintainers. If you find a workflow useful, please star it — this directly influences its relevance ranking for others.

Most Used (new) — A new sort option that orders results by total execution count, making it easy to surface the most widely run workflows.

Expanded Metrics in the Workflow View

Versions Tab

The Versions tab for a workflow now includes a small execution history graph for each listed version, showing monthly execution counts over the past twelve months. This makes it easy to identify which version of a workflow is currently the most active.

In the Versions tab, clicking a version number in the left-hand column sets the version for the other tabs.

Metrics Tab

From there, selecting the Metrics tab surfaces detailed execution information, including several enhancements new to this release.

Workflow-Level Metrics (new) — Near the top of the Metrics page, a collapsible Workflow Metrics section presents the same set of graphs shown in the Version Metrics section below, but aggregated across all versions of the workflow. This provides a convenient high-level summary without requiring you to review each version individually.

Execution Time Distribution (new) — In addition to the existing pie chart and per-version execution count graphs, this release introduces Execution Time Distribution graphs. These show the spread of execution durations — broken down by successful, failed, and aborted runs — giving you a realistic picture of how long the workflow typically takes to complete. For example, in the TheiaCoV_Illumina_PE_PHB v3.1.1 workflow shown above, the majority of executions complete in under ten minutes, though a small number take considerably longer.

CPU and Memory Usage (new data source) — The Metrics page now displays CPU and memory usage data for workflow runs. This capability has existed in Dockstore previously, but as of the past few weeks, Terra has begun reporting resource metrics as part of its workflow execution records, making this data available for Terra-executed workflows. We are actively exploring better ways to present this information. In the meantime, it provides a useful starting point for understanding the resource requirements of a workflow before you run it.

Other Files Support

Dockstore 1.19 introduces Other Files support for workflows. This new feature allows workflow developers to explicitly specify additional files from their repository — such as configuration files, example inputs, or supporting scripts that should be bundled and associated with the workflow when it is packaged for execution.

Other Files is configured through a new field in the .dockstore.yml file. Once specified, these files become accessible alongside the workflow itself, making it easier for users to find everything they need to understand and run the workflow without having to navigate the source repository separately.

# An optional array of absolute paths to other files in the Git repository that should be read and included with the workflow.
    otherFiles:
       - <String>
       - <String>

Security and Bug Fixes

Maintaining system security and our FISMA Moderate compliance is an ongoing process. We regularly update the system to help ensure that we retain this compliance and our security posture.

For More Details

For more details about what has changed in 1.19, please refer to the relevant GitHub repositories. All of the repositories can be found in the Dockstore organization on GitHub.

• dockstore/dockstore (Releases)
• dockstore/dockstore-ui2 (Releases)
• dockstore/dockstore-cli (Releases)
• dockstore/dockstore-documentation (Releases)

If you have questions…

Please refer to the Dockstore documentation and reach out to us on our support forum.