Skip to content

Commit

Permalink
Add note about glibc in install doc
Browse files Browse the repository at this point in the history
  • Loading branch information
hcho3 committed Jun 24, 2024
1 parent e40cf37 commit 6049d20
Showing 1 changed file with 20 additions and 0 deletions.
20 changes: 20 additions & 0 deletions doc/install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,26 @@ Pre-built binary wheels are uploaded to PyPI (Python Package Index) for each rel
You might need to run the command with ``--user`` flag or use ``virtualenv`` if you run
into permission errors.

.. note:: Parts of the Python package now require glibc 2.28+

Starting from 2.1.0, XGBoost Python package will be distributed in two variants:

* ``manylinux_2_28``: for recent Linux distros with glibc 2.28 or newer. This variant comes with all features enabled.
* ``manylinux2014``: for old Linux distros with glibc older than 2.28. This variant does not support GPU algorithms or federated learning.

The ``pip`` package manager will automatically choose the correct variant depending on your system.

Starting from **May 31, 2025**, we will stop distributing the ``manylinux2014`` variant and exclusively
distribute the ``manylinux_2_28`` variant. We made this decision so that our CI/CD pipeline won't have
depend on software components that reached end-of-life (such as CentOS 7). We strongly encourage
everyone to migrate to recent Linux distros in order to use future versions of XGBoost.

Note. If you want to use GPU algorithms or federated learning on an older Linux distro, you have
two alternatives:

1. Upgrade to a recent Linux distro with glibc 2.28+. OR
2. Build XGBoost from the source.

.. note:: Windows users need to install Visual C++ Redistributable

XGBoost requires DLLs from `Visual C++ Redistributable
Expand Down

0 comments on commit 6049d20

Please sign in to comment.