nextflow auth

Added in version 25.10

Manage Seqera Platform authentication.

Usage

$ nextflow auth <subcommand> [options]

Description

The auth command manages authentication and configuration for Seqera. For Seqera Cloud, it uses an OAuth2 authentication flow to generate and save a personal access token (PAT) locally. For Seqera Enterprise installations, it uses direct PAT authentication. Nextflow saves credentials to ~/.nextflow/seqera-auth.config and adds an includeConfig statement to ~/.nextflow/config, or to the configuration file set by $NXF_HOME.

Options

-h, -help

Print the command usage.

Subcommands

login

Authenticate with Seqera and save credentials. Set the Seqera primary compute environment, monitoring, and workspace.

The following options are available:

-u, -url

Seqera API endpoint (default: https://api.cloud.seqera.io).

logout

Remove Seqera authentication and revoke the Seqera Cloud access token, if applicable.

config

Set the Seqera primary compute environment, monitoring, and workspace.

status

Show the Seqera authentication status and configuration.

Examples

Authenticate with Seqera Cloud:

$ nextflow auth login

Authenticate with an Enterprise installation:

$ nextflow auth login -u https://tower.example.com/api

View current authentication status:

$ nextflow auth status

Configure Seqera settings:

$ nextflow auth config

Remove authentication:

$ nextflow auth logout