Skip to content

Commit 912a4bc

Browse files
docs/installation.rst: added section about Linux wheels and glibc compatibility.
1 parent e58f37f commit 912a4bc

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

docs/installation.rst

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -265,6 +265,28 @@ not generally supported:
265265
command line.
266266

267267

268+
Official PyMuPDF Linux wheels may not install on older Linux systems
269+
--------------------------------------------------------------------
270+
271+
Releases of PyMuPDF are incompatible with older Linux systems.
272+
273+
For example as of 2025-09-03, `pip install pymupdf` does not work on some AWS
274+
Lambda systems - see https://github.com/pymupdf/PyMuPDF/discussions/4631.
275+
276+
This is because official PyMuPDF Linux wheels are built with a version of
277+
glibc determined by the current Python manylinux environment. These wheels are
278+
incompatible with Linux systems that have an older glibc.
279+
280+
The official Python manylinux environment is updated periodically to use newer
281+
glibc versions, so new releases of PyMuPDF become increasingly incompatible
282+
with older Linux systems.
283+
284+
There is nothing that can be done about this, other than updating older Linux
285+
systems, or building PyMuPDF locally from source.
286+
287+
For more details, please see: `Python Packaging Authority <https://www.pypa.io>`_.
288+
289+
268290
Packaging
269291
---------
270292

0 commit comments

Comments
 (0)