Skip to content

Publishing simulation projects (COMBINE/OMEX archives)


Authors can publish simulation projects (COMBINE/OMEX archives), their simulation results, and interactive visualizations of their simulation results in three simple steps:

  1. Execute the simulation project with runBioSimulations.
  2. Review the results of the simulation and their visualizations in runBioSimulations.
  3. Use runBioSimulations to publish the run of the project to BioSimulations.

Executing projects

First, execute your simulation project by uploading it to runBioSimulations and selecting a specific simulation tool. Information about how to use runBioSimulations is available here.

Reviewing the simulation results of projects

Second, once the simulation run has completed, use runBioSimulations to inspect its results. We recommend verifying the following aspects of runs:

  • The COMBINE/OMEX archive includes all relevant files.
  • The simulation behaved as expected and the results are visualized as expected.
  • The simulation accurately reproduces biological behavior.
  • The simulation project metadata is accurate and complete.
  • The thumbnail image displays correctly.

More information about using runBioSimulations to review simulation results is available here.

Publishing projects


Third, once the simulation run has completed and its results have been reviewed, publish the run to BioSimulations by clicking the "Publish" button on the page for the run. Then select a unique id for the project, consent to BioSimulations' terms, and click the "Publish" button.

Using BioSimulators to test projects prior to submission to BioSimulations

BioSimulations uses BioSimulators Docker containers to execute simulation projects. This allows authors to run simulation projects locally using the same simulator containers as runBioSimulations. The containerized simulation tools provide a consistent environment and interface that matches that provided on runBioSimulations. This consistency makes it easy for authors to debug problems by enabling authors to use their own machines to interactively run the same simulations as runBioSimulations. For more detailed information and alternative methods to simulating projects see the simulating projects guide.

To run a project locally, pull the appropriate BioSimulators Docker image, and then run the simulator as follows:

docker run -v /path/to/project:/root -v /path/to/output:/root/out -i archive.omex -o /root/out


Ensure that the directories containing the archive.omex file and the output directory are mounted in the container. For more information, see the Docker documentation here.

User accounts for owning projects

No login is required to access BioSimulations. However, users must have an account to manage projects. This allows for proper crediting of authors, and it allows authors to manage and edit their projects. These accounts are available for free.


User accounts are under development. If you are interested in an account, please contact us at

Privately sharing resources with colleagues, peer reviewers, and editors before publication


Before publishing a simulation run, you can share the run privately by providing colleagues the URL of the simulation run on This link can be retrieved by clicking on the "Share" button in the simulation run view page.

Last update: 2023-04-15