10x Genomics

Operating System Support

In the interests of serving as many of our customers as possible, 10x Genomics works to ensure our pipelines 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.

OS Version Vendor Support End Date 10x Genomics Support
May 2018 November 2021 March 2023 2025
Ubuntu
10.04April 2017 incompatible incompatible incompatible incompatible
12.04April 2017 deprecated incompatible incompatible incompatible
14.04April 2019 supported deprecated unsupported incompatible
16.04April 2021 supported supported supported incompatible
18.04April 2023 supported supported supported supported
20.04April 2025 supported supported supported supported
22.04April 2027 supported supported supported supported
RedHat and CentOS
5March 2017 incompatible incompatible incompatible incompatible
6November 2020 supported incompatible incompatible incompatible
7June 2024 supported supported supported incompatible
8May 2029 supported supported supported supported

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

Deprecation Warnings

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:

$ TENX_IGNORE_DEPRECATED_OS=1 cellranger wgs...

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

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

As always, feel free to reach out to [email protected] with any questions or concerns.


Compatibility with Other Linux Distributions

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 examples are not tested or officially supported by 10x Genomics, but customers have reported success with them in the past.

Kernel Version GNU libc Version Example Distributions 10x Genomics Compatibility
May 2018November 20212025
2.6.232.5 SuSE 11, Debian 6 incompatible incompatible incompatible
2.6.322.12 Debian 7, Fedora 11 compatible incompatible incompatible
3.10.02.17 SuSE 12, Debian 8, Fedora 20 compatible compatible incompatible
4.14.262.17 Amazon Linux 2018.03 compatible compatible incompatible
4.9.02.24 Debian 9, Arch 2017.02 compatible compatible incompatible
4.18+2.26+ Amazon Linux 2, Debian 10, SUSE 15 compatible compatible compatible

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.