Skip to main content
Version: 23.2

Use Tower

You can use Tower through the web interface, the API, the CLI, or in Nextflow directly using the -with-tower option.

Tower web interface

  1. Create an account and log in to Tower, available free of charge at tower.nf.

  2. Create and configure a new compute environment.

  3. Start launching pipelines.

Tower API

See API.

Tower CLI

See CLI.

Nextflow -with-tower

  1. Create an account and log in to Tower.

  2. Create a new token. You can access your tokens from the Settings drop-down menu:

  3. Name your token.

  4. Store your token securely.

The token will only be displayed once. You must copy and save the token before closing the Personal Access Token window.

  1. Open a terminal and enter the following commands:

    export TOWER_ACCESS_TOKEN=eyxxxxxxxxxxxxxxxQ1ZTE=
    export NXF_VER=23.1.3

    Replace eyxxxxxxxxxxxxxxxQ1ZTE= with your newly-created token.

Bearer token support requires Nextflow version 20.10.0 or later, set with the second command above.

To submit a pipeline to a workspace using Nextflow, add the workspace ID to your environment:

export TOWER_WORKSPACE_ID=000000000000000

The workspace ID can be found on the organization workspaces overview page.

  1. Run your Nextflow pipeline with the -with-tower flag:

    nextflow run hello.nf -with-tower

    You can now monitor your workflow runs in Tower.

    To configure and execute Nextflow pipelines in cloud environments, see Compute Environments.

See the Nextflow documentation for further run configuration options using Nextflow configuration files.