diff --git a/.github/workflows/fleet-and-orbit.yml b/.github/workflows/fleet-and-orbit.yml index c17b33b42e..ab5fa80899 100644 --- a/.github/workflows/fleet-and-orbit.yml +++ b/.github/workflows/fleet-and-orbit.yml @@ -203,7 +203,13 @@ jobs: strategy: matrix: go-version: ['${{ vars.GO_VERSION }}'] - runs-on: macos-latest + # Set macOS version to '12' (current equivalent to macos-latest) for + # building the binary. This ensures compatibility with macOS version 13 and + # later, avoiding runtime errors on systems using macOS 13 or newer. + # + # Note: Update this version to '13' once GitHub marks macOS 13 as stable + # or if we revise our minimum supported macOS version. + runs-on: macos-12 steps: - name: Install Go diff --git a/.github/workflows/generate-desktop-targets.yml b/.github/workflows/generate-desktop-targets.yml index 19f31f7e19..8bc4c50448 100644 --- a/.github/workflows/generate-desktop-targets.yml +++ b/.github/workflows/generate-desktop-targets.yml @@ -31,7 +31,13 @@ permissions: jobs: desktop-macos: - runs-on: macos-latest + # Set macOS version to '12' (current equivalent to macos-latest) for + # building the binary. This ensures compatibility with macOS version 13 and + # later, avoiding runtime errors on systems using macOS 13 or newer. + # + # Note: Update this version to '13' once GitHub marks macOS 13 as stable + # or if we revise our minimum supported macOS version. + runs-on: macos-12 steps: - name: Install Go diff --git a/tools/tuf/test/README.md b/tools/tuf/test/README.md index fdda35f84c..e8c2c3647c 100644 --- a/tools/tuf/test/README.md +++ b/tools/tuf/test/README.md @@ -82,4 +82,20 @@ make desktop-app-tar-gz # Push the desktop target as a new version ./tools/tuf/test/push_target.sh macos desktop desktop.app.tar.gz 43 -``` \ No newline at end of file +``` + +### Troubleshooting + +#### Fleet Desktop Startup Issue on macOS + +When running Fleet Desktop on an older macOS version than it was compiled on, Orbit may not launch it due to an error: + +``` +_LSOpenURLsWithCompletionHandler() failed with error -10825 +``` + +Solution: `Set the MACOSX_DEPLOYMENT_TARGET` environment variable to the lowest macOS version you intend to support: + +``` +export MACOSX_DEPLOYMENT_TARGET=13 # replace '13' with your target macOS version +```