diff --git a/.github/workflows/generate-docs.yml b/.github/workflows/generate-docs.yml
index af2ac66..6efa5db 100644
--- a/.github/workflows/generate-docs.yml
+++ b/.github/workflows/generate-docs.yml
@@ -33,7 +33,14 @@ jobs:
       - name: Install tooling
         run: |
           sudo apt-get update
-          sudo apt-get install -y docker-compose-plugin graphviz jq python3 python3-pip
+          sudo apt-get install -y graphviz jq python3 python3-pip
+          if ! docker compose version >/dev/null 2>&1; then
+            sudo apt-get install -y docker-compose-v2 || sudo apt-get install -y docker-compose || true
+          fi
+          if ! docker compose version >/dev/null 2>&1; then
+            echo "docker compose CLI is unavailable on this runner" >&2
+            exit 1
+          fi
           python3 -m pip install --user pyyaml jinja2
       - name: Generate documentation
         run: |