diff --git a/.github/workflows/publish.yaml b/.github/workflows/publish.yaml
index 552dbfc02b23..95054b816986 100644
--- a/.github/workflows/publish.yaml
+++ b/.github/workflows/publish.yaml
@@ -20,7 +20,14 @@ jobs:
         run: sudo python3 -m pip install gitpython pandocfilters
 
       - name: Install mermaid diagram filter
-        run: sudo npm install --global mermaid-filter
+        run: |
+          sudo npm cache clean --force
+          sudo npm install --loglevel verbose --global mermaid-filter
+
+      - name: Ensure Puppeteer (Chromium API) is fully installed
+        run: |
+          sudo node /usr/local/lib/node_modules/puppeteer/install.js
+          echo sudo snap install chromium
 
       - name: Build documentation
         run: cd doc/doxygen-root && make && touch html/.nojekyll