GitHub Actions Unsupported runner OS

The workflow specifies a runner OS that is not supported.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
What is

GitHub Actions Unsupported runner OS

 ?

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.

Attached error: 
GitHub Actions Unsupported runner OS
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

Master 

GitHub Actions

 debugging in Minutes

— Grab the Ultimate Cheatsheet

(Perfect for DevOps & SREs)

Most-used commands
Real-world configs/examples
Handy troubleshooting shortcuts
Your email is safe with us. No spam, ever.

Thankyou for your submission

We have sent the cheatsheet on your email!
Oops! Something went wrong while submitting the form.

GitHub Actions

Cheatsheet

(Perfect for DevOps & SREs)

Most-used commands
Your email is safe thing.

Thankyou for your submission

We have sent the cheatsheet on your email!
Oops! Something went wrong while submitting the form.

MORE ISSUES

Deep Sea Tech Inc. — Made with ❤️ in Bangalore & San Francisco 🏢

Doctor Droid