diff --git a/.github/workflows/asciidoctor-ghpages.yml b/.github/workflows/asciidoctor-ghpages.yml
index 1182a6c8..fb56ff65 100644
--- a/.github/workflows/asciidoctor-ghpages.yml
+++ b/.github/workflows/asciidoctor-ghpages.yml
@@ -40,7 +40,8 @@ jobs:
           node-version: 20
       - name: Install Mermaid
         run: |
-          sudo npm install -g @mermaid-js/mermaid-cli@11.2.0
+          sudo npm install -g @mermaid-js/mermaid-cli@11.2.1
+          npx puppeteer browsers install chrome-headless-shell
       - name: Install asciidoctor
         run: |
           sudo apt update
diff --git a/.gitignore b/.gitignore
index 46e6f7c5..06b64f90 100644
--- a/.gitignore
+++ b/.gitignore
@@ -12,3 +12,4 @@ CMakePresets.json
 /toolchains
 mull.yml
 requirements.txt
+docs/puppeteer_config.json
diff --git a/docs/index.adoc b/docs/index.adoc
index fdba3650..f8654892 100644
--- a/docs/index.adoc
+++ b/docs/index.adoc
@@ -5,6 +5,7 @@
 :rouge-style: base16.solarized
 :source-language: c++
 :toc: left
+:mermaid-puppeteer-config: puppeteer_config.json
 
 include::intro.adoc[]
 include::flows.adoc[]