, printed on 12/25/2024
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.04 | April 2017 | incompatible | incompatible | incompatible | incompatible |
| 12.04 | April 2017 | deprecated | incompatible | incompatible | incompatible |
| 14.04 | April 2019 | supported | deprecated | unsupported | incompatible |
| 16.04 | April 2021 | supported | supported | supported | incompatible |
| 18.04 | April 2023 | supported | supported | supported | supported |
| 20.04 | April 2025 | supported | supported | supported | supported |
| 22.04 | April 2027 | supported | supported | supported | supported |
| RedHat and CentOS | |||||
| 5 | March 2017 | incompatible | incompatible | incompatible | incompatible |
| 6 | November 2020 | supported | incompatible | incompatible | incompatible |
| 7 | June 2024 | supported | supported | supported | incompatible |
| 8 | May 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.
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.
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 2018 | November 2021 | 2025 | |||
| 2.6.23 | 2.5 | SuSE 11, Debian 6 | incompatible | incompatible | incompatible |
| 2.6.32 | 2.12 | Debian 7, Fedora 11 | compatible | incompatible | incompatible |
| 3.10.0 | 2.17 | SuSE 12, Debian 8, Fedora 20 | compatible | compatible | incompatible |
| 4.14.26 | 2.17 | Amazon Linux 2018.03 | compatible | compatible | incompatible |
| 4.9.0 | 2.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.