Advanced options

You can modify the configuration and execution of a pipeline with advanced launch options.

Nextflow config file

Add settings to the Nextflow configuration file. This must follow the same syntax as the Nextflow configuration file.

Nextflow parameters defined in this field override the same parameters in your nextflow.config file.

For example, modify the manifest section to give the pipeline a name and description that will show up in the Seqera monitoring section:

    manifest {
        name = 'My_RNASeq_Pipeline'
        description = 'Generates RNASeq results using a test profile'
        mainScript = 'main.nf'
        defaultBranch = 'master'
    }

Seqera Cloud config file

Configure per-pipeline Seqera reporting behavior. Settings specified here override the same settings in the tower.yml configuration file for this execution. Use the reports key to specify report paths, titles, and MIME types:

reports:
  reports/multiqc/index.html:
    display: "MultiQC Reports"
    mimeType: "text/html"

Pre and post-run scripts

Run custom code either before or after the execution of the Nextflow script. These fields allow you to enter shell commands.

Pre-run scripts are executed in the nf-launch script prior to invoking Nextflow processes. Pre-run scripts are useful for:

• Specifying an alternate Nextflow version to use for the run. For example, use export NXF_VER=24.04.2 to take advantage of new Nextflow features before a Platform version is released with 24.04.2 as its baseline.
• Executor setup, such as loading a private CA certificate.
• Troubleshooting. For example, add sleep 3600 to your pre-run script to instruct Nextflow to wait 3600 seconds (60 minutes) before process execution after the nf-launcher container is started, to create a window in which to test connectivity and other issues before your Nextflow processes execute.

Post-run scripts are executed after all Nextflow processes have completed. Post-run scripts are useful for triggering a third party service via API request.

Pull latest

Instruct Nextflow to pull the latest pipeline version from the Git repository. This is equivalent to using the -latest flag.

Stub run

Replace Nextflow process commands with command stubs, where defined, before execution.

Main script

Nextflow will attempt to run the script named main.nf in the project repository by default. You can configure a custom script filename in manifest.mainScript or you can provide the script filename in this field.

If you specify a custom script filename, the root of the default branch in your pipeline repository must still contain blank main.nf and nextflow.config files. See Nextflow configuration for more information on this known Nextflow behavior.

Workflow entry name

Nextflow DSL2 provides the ability to launch workflows with specific names. Enter the name of the workflow to be executed in this field.

Schema name

Specify the name of a pipeline schema file in the workflow repository root folder to override the default nextflow_schema.json.

Head job CPUs and memory

Specify the compute resources allocated to the Nextflow head job. These fields are only displayed for runs executing on AWS Batch and Azure Batch compute environments.