Frequently Asked Questions

If your question is not listed, try using DeepWiki's AI assistant for common issues.

For unresolved problems, join our Discord or WeChat community for support.

Encountered the error ImportError: libGL.so.1: cannot open shared object file: No such file or directory in Ubuntu 22.04 on WSL2

The libgl library is missing in Ubuntu 22.04 on WSL2. You can install the libgl library with the following command to resolve the issue:

sudo apt-get install libgl1-mesa-glx

Reference: #388

Missing text information in parsing results when installing and using on Linux systems.

MinerU uses pypdfium2 instead of pymupdf as the PDF page rendering engine in versions >=2.0 to resolve AGPLv3 license issues. On some Linux distributions, due to missing CJK fonts, some text may be lost during the process of rendering PDFs to images. To solve this problem, you can install the noto font package with the following commands, which are effective on Ubuntu/Debian systems:

sudo apt update
sudo apt install fonts-noto-core
sudo apt install fonts-noto-cjk
fc-cache -fv

You can also directly use our Docker deployment method to build the image, which includes the above font packages by default.

Reference: #2915