In the interests of serving as many of our customers as possible, 10x Genomics works to ensure our pipelines (including Cell Ranger, Cell Ranger ARC, Cell Ranger ATAC, Xenium Ranger, and Space Ranger) run on popular Linux distributions. We maintain compatibility with older versions as long as practical, even beyond their vendor support.

The table below summarizes our intended operating system support schedule. When a 10x Genomics software is released following one of the indicated dates, users will see a warning message about the deprecated system. For operating system compatibility information for any specific 10x Genomics software version, please refer to the release notes for that version.

The following table lists the 10x Genomics support schedule for Debian derivatives, including Ubuntu.

The following table lists the 10x Genomics support schedule for Red Hat Enterprise Linux.

While 10x Genomics cannot test on every distribution, and therefore cannot guarantee support, we expect most "rebuilds" of RedHat, such as CentOS, Rocky, Alma, and Fermilab's Scientific Linux, to have equivalent compatibility.

If you have seen a deprecation warning, it is because your current operating system is out of date and support is expected to end soon. 10x Genomics recommends upgrading to a more recent release, but we understand that may not be immediately practical. You can acknowledge the deprecation warning and run the pipeline on your current operating system by setting the TENX_IGNORE_DEPRECATED_OS environment variable before running the pipeline:

Copy
$ TENX_IGNORE_DEPRECATED_OS=1 cellranger wgs...

Or, you can set up your shell to remember this preference:

Copy
$ echo "export TENX_IGNORE_DEPRECATED_OS=1" >> ~/.bashrc
$ source ~/.bashrc

Reach out to support@10xgenomics.com with any questions or concerns.

Due to the general interoperability of Linux distributions, software written and tested on one often works on others. However, there are sometimes important differences, and 10x Genomics cannot test or support on all possible platforms. The main constraints on compatibility between Linux versions are due to the kernel and GNU libc versions. The following table lists the expected timeline for pipeline software compatibility. The distribution versions listed as compatible are not tested or officially supported by 10x Genomics, but customers have reported success with them in the past. Distributions listed as supported have been tested in-house.

If your operating system is not listed, you can compare the kernel version returned by uname -r and glibc version returned by ldd --version with the above table. 10x Genomics is not aware of any issues specific to versions newer than the ones listed above.