diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index f82005c..93e7581 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -32,10 +32,23 @@ jobs:
         with:
           python-version: "3.13"
 
+      - name: Install Qt runtime libraries
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes --no-install-recommends \
+            libdbus-1-3 \
+            libegl1 \
+            libfontconfig1 \
+            libglib2.0-0 \
+            libgl1 \
+            libxkbcommon0
+
       - name: Install the package with documentation dependencies
         run: python -m pip install ".[doc]"
 
       - name: Build documentation
+        env:
+          QT_QPA_PLATFORM: offscreen
         run: python -m sphinx -W --keep-going -b html docs/source docs/build/html
 
       - name: Disable Jekyll processing