GitHub Actions Unsupported runner OS

The workflow specifies a runner OS that is not supported.

Understanding GitHub Actions

GitHub Actions is a powerful automation tool integrated into GitHub, designed to help developers automate their software development workflows. It allows you to build, test, and deploy your code directly from your GitHub repository. By using workflows defined in YAML files, developers can automate tasks such as CI/CD, code linting, and more.

Identifying the Symptom: Unsupported Runner OS

When using GitHub Actions, you might encounter an error message stating 'Unsupported runner OS'. This error typically appears when the workflow attempts to execute on a runner operating system that is not supported by GitHub Actions.

Common Error Message

The error message usually looks like this:

Error: Unsupported runner OS

Exploring the Issue: Unsupported Runner OS

The root cause of this issue is that the workflow file specifies a runner OS that GitHub Actions does not support. GitHub Actions provides a set of predefined virtual environments, each with a specific operating system, such as Ubuntu, Windows, and macOS. If your workflow specifies an OS outside these options, the error will occur.

Supported Runner OS Options

As of the latest update, GitHub Actions supports the following runner OS options:

  • ubuntu-latest
  • ubuntu-22.04
  • ubuntu-20.04
  • ubuntu-18.04
  • windows-latest
  • windows-2022
  • windows-2019
  • macos-latest
  • macos-12
  • macos-11

For the most up-to-date list, refer to the GitHub documentation.

Steps to Fix the Unsupported Runner OS Issue

To resolve the 'Unsupported runner OS' error, follow these steps:

Step 1: Review Your Workflow File

Open your workflow YAML file, typically located in the .github/workflows directory of your repository. Look for the runs-on key, which specifies the runner OS.

Step 2: Update the Runner OS

Ensure that the runs-on key is set to one of the supported OS options. For example, if your workflow currently specifies an unsupported OS, update it to a supported one:

runs-on: ubuntu-latest

Step 3: Commit and Push Changes

After updating the workflow file, commit your changes and push them to your GitHub repository:

git add .github/workflows/your-workflow-file.yml
git commit -m "Update runner OS to a supported version"
git push origin main

Step 4: Re-run the Workflow

Navigate to the Actions tab in your GitHub repository and re-run the workflow to verify that the issue is resolved.

Conclusion

By ensuring your workflow specifies a supported runner OS, you can avoid the 'Unsupported runner OS' error and ensure your GitHub Actions workflows run smoothly. Always refer to the GitHub Actions documentation for the latest updates and supported environments.

Never debug

GitHub Actions

manually again

Let Dr. Droid create custom investigation plans for your infrastructure.

Book Demo
Automate Debugging for
GitHub Actions
See how Dr. Droid creates investigation plans for your infrastructure.

MORE ISSUES

Made with ❤️ in Bangalore & San Francisco 🏢

Doctor Droid