From 696cecfecb9ee1bbf551ee3696b3f94b3db3559a Mon Sep 17 00:00:00 2001
From: beatz174-bit <beatz174@gmail.com>
Date: Wed, 13 May 2026 07:49:34 +1000
Subject: [PATCH] ci: make compose installation resilient on ubuntu runners

---
 .github/workflows/generate-docs.yml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

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: |