Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Installation/Setup

We provide installation and run instructions for both local runs and cloud runs with Seqera Platform.

Local installation is best for development, testing, or running on a single server. We recommend you perform a local installation regardless of whether you will eventually also run at scale in Seqera Platform so that you can simply run minimal test pipelines.

Cloud execution with Seqera Platform is recommended for production runs at scale. Seqera Platform (formerly Nextflow Tower) provides a web interface for launching, monitoring, and managing Nextflow pipelines on cloud infrastructure.

Local Installation of Nextflow

Local Prerequisites

  1. Java: Version 11 or later

  2. Nextflow: Version 25.04.0 or later

  3. Docker: Engine must be installed and running

Local Setup

  1. Install Nextflow:

    curl -s https://get.nextflow.io | bash
    mv nextflow /usr/local/bin/
  2. Verify installation:

    nextflow run broadinstitute/nf-pooled-cellpainting -profile docker --help -r dev

After successfully verifying installation, we recommend you run the local test example.

Cloud Setup of Seqera Platform

AWS Prerequisites

  1. Seqera Platform Account: Access to a workspace at cloud.seqera.io

  2. AWS Account: With permissions to create Batch resources

  3. AWS Credentials: Configured in Seqera Platform

  4. S3 Bucket: For work directory and data storage

Setting Up an AWS Batch Compute Environment

From your Seqera Platform workspace, navigate to Compute EnvironmentsAdd Compute Environment.

Basic Configuration

SettingRecommended ValueNotes
NameAWSBatch_pooled_cellpaintingDescriptive name
PlatformAWS Batch
CredentialsYour AWS credentialsMust have AWS Batch permissions
Regionus-east-1 (or your preferred region)Should match your S3 bucket
Work directorys3://your-bucket/workPipeline scratch data
FeatureDescriptionRecommendation
Wave containersContainer provisioning serviceEnable for easier container management
Fusion v2Virtual distributed file system for S3Enable for faster S3 access
Fast instance storageNVMe for faster I/OEnable if using Fusion v2
Fusion SnapshotsAuto-restore on spot interruptionEnable for spot instance resilience

Config Mode: Batch Forge

Select Batch Forge for automated queue creation. Seqera will create:

Forge Configuration

SettingRecommended ValueNotes
Provisioning modelSpotCost-effective; use On-demand for critical runs
Max CPUs2000Total CPU pool; adjust based on workload
Allowed S3 bucketsYour data bucket(s)Grant read-write access
EFS/FSxNoneNot required for most use cases

Advanced Options: Instance Types

For image processing workloads, select instance families with:

Recommended instance types:

After setup, we recommend you run the test example.