Support homeCell RangerDownloads
System Requirements

System Requirements

Cell Ranger pipelines run on Linux systems that meet these minimum requirements:

  • 8-core Intel or AMD processor (64 cores recommended), which support the AVX+ instruction set, introduced in 2011 on both Intel and AMD CPUs. AVX2 will be required in the future, introduced in 2013 on Intel CPUs and in 2015 on AMD CPUs.
  • 64 GB RAM (128 GB recommended).
  • 1.5 TB free disk space.
  • 64-bit CentOS/RedHat 7.0 or Ubuntu 14.04. See the 10x Genomics OS Support page for additional details.

Larger datasets require additional resources. The following table indicates the requirements to keep runtimes less than 3 days for representative small, medium, and large datasets:

SmallMediumLarge
Dataset details20k (3’/5’/Flex - GEX), 10-20k reads/cell320k (Flex - GEX+AB), 200 features, 10k reads/cell1M (Flex v2 - GEX+AB+CRISPR), 500 features, 10k GEX reads/cell
Processor8-core Intel or AMD processor, with AVX+ instruction set16-core Intel or AMD processor, with AVX+ instruction set32-core Intel or AMD processor, with the AVX+ instruction set
RAM64 GB RAM256 GB RAM512 GB RAM
Free disk space1.5 TB2 TB6 TB

The pipelines also run on clusters that meet these additional minimum requirements:

  • Shared filesystem (e.g. NFS)
  • Slurm batch scheduling system

Running Cell Ranger in cluster mode is recommended for large datasets.

Cell Ranger v9.0 introduced support for generating automated cell type annotations (beta pipeline). To use this optional feature, you will need a 10x Genomics Cloud Analysis account and a stable internet connection, as your data will be transmitted to the cloud for processing.

Most software dependencies come bundled in the Cell Ranger package. However, cellranger mkfastq (deprecated) also requires Illumina bcl2fastq v2.20 or later.

  • Cell Ranger runs locally by default (or when specified as --jobmode=local), using 90% of available memory and all of the available cores. To restrict resource usage, please use the --localmem and --localcores options (see cellranger vdj --help).

  • Many Linux systems have default user limits (ulimits) for maximum open files and maximum user processes as low as 1024 or 4096. Because Cell Ranger spawns multiple processes per core, jobs that use a large number of cores can exceed these limits. We recommend higher limits:

LimitRecommendation
user open files16k
system max files10k per GB RAM available to Cell Ranger
user processes64 per core available to Cell Ranger

The following table is based on time trials using Amazon EC2 instances and Cell Ranger v10.0. Empirical performance will be impacted by numerous factors, including processors, RAM, hard disks, library type, read depth, number of cells, number of cores/threads, and I/O. The data are meant to convey how increasing dataset size may impact Cell Ranger's performance, but may not be representative of your dataset.

Metric20k Universal (GEX)320k Flex V1 (GEX+AB)1M Flex V2 (GEX+AB+CRISPR)
AWS Instance typem4.4xlarger5.8xlarger7i.16xlarge
Core Hours88.10632.91010.1
Wall Time (hr)9.1126.4947.32
High Water Mark (GB)27019894200
Estimated compute cost ($0.04 * core hour)$3.52$25.31$40.40