---
title: Configuration options
description: Overview of the config scopes that are available in the Nextflow configuration.
---

# Configuration options

The [Nextflow configuration][config-page] is organized into config scopes. The following pages describe the available settings in each scope.

Each setting is listed by its fully qualified name, which includes the enclosing scopes. You can write a setting using either dot syntax or block syntax:

```groovy
// dot syntax
docker.enabled = true
docker.runOptions = '-u $(id -u):$(id -g)'

// block syntax
docker {
    enabled = true
    runOptions = '-u $(id -u):$(id -g)'
}
```

See [Blocks][config-blocks] for more information about the two forms.

## Config scopes

| Page | Description |
| ---- | ----------- |
| [Unscoped options][config-unscoped] | Settings that are not part of a config scope. |
| [<code style={{whiteSpace: 'nowrap'}}>appleContainer</code>][config-apple-container] | Controls how [Apple container](https://github.com/apple/container) is used by Nextflow. |
| [`apptainer`][config-apptainer] | Controls how [Apptainer](https://apptainer.org) containers are executed by Nextflow. |
| [`aws`][config-aws] | Controls the interactions with AWS, including AWS Batch and S3. |
| [`azure`][config-azure] | Controls the interactions with Azure, including Azure Batch and Azure Blob Storage. |
| [`charliecloud`][config-charliecloud] | Controls how [Charliecloud](https://hpc.github.io/charliecloud/) containers are executed by Nextflow. |
| [`conda`][config-conda] | Controls the creation of Conda environments by the Conda package manager. |
| [`dag`][config-dag] | Controls the generation of the [workflow diagram][workflow-diagram]. |
| [`docker`][config-docker] | Controls how [Docker](https://www.docker.com) containers are executed by Nextflow. |
| [`env`][config-env] | Defines environment variables that are exported into the environment where tasks are executed. |
| [`executor`][config-executor] | Controls various executor behaviors. |
| [`fusion`][config-fusion] | Provides advanced configuration for the use of the [Fusion file system][fusion-page]. |
| [`google`][config-google] | Controls the interactions with Google Cloud, including Google Cloud Batch and Google Cloud Storage. |
| [`k8s`][config-k8s] | Controls the deployment and execution of workflow applications in a Kubernetes cluster. |
| [`lineage`][config-lineage] | Controls the generation of [lineage][cli-lineage] metadata. |
| [`mail`][config-mail] | Controls the mail server used to send email notifications. |
| [`manifest`][config-manifest] | Defines pipeline metadata that is useful when publishing or running your pipeline. |
| [`nextflow`][config-nextflow] | Controls the retry policy used for retryable operations. |
| [`notification`][config-notification] | Controls the automatic sending of an email notification on workflow completion. |
| [`podman`][config-podman] | Controls how [Podman](https://podman.io/) containers are executed by Nextflow. |
| [`registry`][config-registry] | Configures the registries used to resolve [modules][module-registry-page] and [plugins][plugin-registry-page]. |
| [`report`][config-report] | Controls the generation of the [execution report][execution-report]. |
| [`sarus`][config-sarus] | Controls how [Sarus](https://sarus.readthedocs.io) containers are executed by Nextflow. |
| [`seqera`][config-seqera] | Controls the interactions with Seqera services. |
| [`shifter`][config-shifter] | Controls how [Shifter](https://docs.nersc.gov/programming/shifter/overview/) containers are executed by Nextflow. |
| [`singularity`][config-singularity] | Controls how [Singularity](https://sylabs.io/singularity/) containers are executed by Nextflow. |
| [`smolvm`][config-smolvm] | Controls how [smolvm](https://github.com/smol-machines/smolvm) microVMs are used by Nextflow. |
| [`spack`][config-spack] | Controls the creation of Spack environments by the Spack package manager. |
| [`timeline`][config-timeline] | Controls the generation of the [execution timeline][timeline-report]. |
| [`tower`][config-tower] | Controls the settings for [Seqera Platform](https://seqera.io) (formerly Tower Cloud). |
| [`trace`][config-trace] | Controls the generation of the [trace file][trace-report]. |
| [`wave`][config-wave] | Provides advanced configuration for the use of [Wave containers][wave-page]. |
| [`workflow`][config-workflow] | Provides workflow execution options. |

[cli-lineage]: ./cli/lineage
[config-apple-container]: ./config/apple-container
[config-apptainer]: ./config/apptainer
[config-aws]: ./config/aws
[config-azure]: ./config/azure
[config-blocks]: ../config#blocks
[config-charliecloud]: ./config/charliecloud
[config-conda]: ./config/conda
[config-dag]: ./config/dag
[config-docker]: ./config/docker
[config-env]: ./config/env
[config-executor]: ./config/executor
[config-fusion]: ./config/fusion
[config-google]: ./config/google
[config-k8s]: ./config/k8s
[config-lineage]: ./config/lineage
[config-mail]: ./config/mail
[config-manifest]: ./config/manifest
[config-nextflow]: ./config/nextflow
[config-notification]: ./config/notification
[config-page]: ../config
[config-podman]: ./config/podman
[config-registry]: ./config/registry
[config-report]: ./config/report
[config-sarus]: ./config/sarus
[config-seqera]: ./config/seqera
[config-shifter]: ./config/shifter
[config-singularity]: ./config/singularity
[config-smolvm]: ./config/smolvm
[config-spack]: ./config/spack
[config-timeline]: ./config/timeline
[config-tower]: ./config/tower
[config-trace]: ./config/trace
[config-unscoped]: ./config/unscoped
[config-wave]: ./config/wave
[config-workflow]: ./config/workflow
[execution-report]: ../reports#execution-report
[fusion-page]: ../fusion
[module-registry-page]: ../modules/module-registry
[plugin-registry-page]: ../plugins/plugin-registry
[timeline-report]: ../reports#execution-timeline
[trace-report]: ../reports#trace-file
[wave-page]: ../wave
[workflow-diagram]: ../reports#workflow-diagram
