Skip to content

Usage#

You can use Tower via either the online GUI, using the -with-tower option with the Nextflow run command, or through the API.

Via online GUI#

1. Create an account and login into Tower, available free of charge, at tower.nf.

2. Create and configure a new compute environment.

3. Start launching pipelines.

Via Nextflow run command#

Create an account and login into Tower.

1. Create a new token

You can access your tokens from the The Settings drop-down menu or directly from this link:

2. Name your token

3. Save your token safely

Copy and keep your new token in a safe place.

4. Export your token

Once your token has been created, open a terminal and type:

1
2
export TOWER_ACCESS_TOKEN=eyxxxxxxxxxxxxxxxQ1ZTE=
export NXF_VER=20.10.0

Where eyxxxxxxxxxxxxxxxQ1ZTE= is the token you have just created.

check your Nextflow version

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

5. Run Nextflow with tower

Run your Nextflow workflows as usual with the addition of the -with-tower command:

1
nextflow run hello.nf -with-tower

You will see and be able to monitor your Nextflow jobs in Tower.

To configure and execute Nextflow jobs in Cloud environments, visit the Compute environments section.

API#

To learn more about using the Tower API, visit to the API section in this documentation.