Skip to main content
Version: 25.3

Wave containers

Wave is Seqera's container provisioning service that enables on-demand container image management for Nextflow pipelines. Wave can provision containers dynamically during pipeline execution, removing the need to manually build and upload images to a container registry.

Deployment options

Wave can be integrated with Seqera Platform in two ways:

  • Seqera Wave service: Use the hosted Wave service at https://wave.seqera.io (default for Seqera Cloud)
  • Self-hosted Wave: Deploy Wave in your own infrastructure for full control over container builds and caching

Requirements

Network connectivity

SourceDestinationPurpose
Seqera PlatformWave serverAPI communication
Container registryWave serverAllow ingress for container operations
Compute environmentsWave serverContainer image access during pipeline execution

Container registry credentials

Container registry credentials must be configured in the Seqera UI to authenticate with your private or public registries. See container registry credentials for provider-specific instructions.

Configuration

Connect to Wave service

Configure Seqera Platform to use the Seqera-hosted Wave service or your self-hosted Wave deployment:

VariableDescription
TOWER_ENABLE_WAVESet to true to enable Wave integration
WAVE_SERVER_URLWave server endpoint (default: https://wave.seqera.io)

Verify connectivity

Test connectivity to your Wave server:

curl https://wave.seqera.io/service-info

Replace wave.seqera.io with your self-hosted Wave endpoint if applicable.

Features enabled by Wave

After Wave is enabled, the following features become available:

  • Private container registries: Access containers from private repositories using credentials stored in Seqera
  • Fusion file system: High-performance cloud-native file system for pipeline execution
  • Container augmentation: Dynamically extend existing containers with additional layers
  • Conda-based containers: Provision containers from Conda or Bioconda packages on demand
  • Singularity support: Build and provision Singularity/Apptainer format containers
  • Security scanning: Automatic vulnerability scanning of built container images

Wave features are available on the compute environment creation page after integration is configured.

Limitations

  • Wave does not support container repositories with private CA SSL certificates

Self-hosted Wave deployment

For enterprises requiring full control over container builds, caching, and security scanning, Wave can be deployed in your own infrastructure.

Self-hosted Wave supports:

  • Wave Lite: Container augmentation and inspection capabilities (AWS, Azure, GCP)
  • Full Wave: Complete build capabilities including Conda-based containers and security scanning (requires AWS EKS with EFS storage)

See the Wave documentation for installation and configuration guidance.

Additional resources