Resolving PEX Compatibility Issues in GitHub Actions for Dagster Cloud

Last updated: October 21, 2025

When encountering PEX compatibility issues with Dagster Cloud GitHub Actions, particularly around cryptography wheels or other dependencies, the primary solution is to use a compatible GitHub Actions runner image. Ubuntu-latest or ubuntu-22.04 runners are recommended and officially supported.

To resolve these issues:

  1. Update your workflow YAML to use ubuntu-latest or ubuntu-22.04 as the runner

  2. Use Python 3.11 for better wheel compatibility

  3. Add pip caching for improved performance

     runs-on: ubuntu-latest
      steps:
        - name: Set up Python
          uses: actions/setup-python@v4
          if: steps.prerun.outputs.result != 'skip'
          with:
            python-version: "3.11"
            cache: 'pip'
    
        - name: Install build dependencies
          if: steps.prerun.outputs.result != 'skip'
          run: |
            python -m pip install --upgrade pip setuptools wheel
            pip install --upgrade cryptography>=3.4.0
            pip install --upgrade PyJWT

These compatibility issues typically arise when using older Ubuntu versions (like ubuntu-20.04) which may not be compatible with the PEX environment used by the Dagster Cloud GitHub Action. The error manifests as failing to find compatible interpreters or resolve wheel dependencies for various packages.