Skip to content

docs: add supported runners table to frontmatter reference #17361

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Mossaka wants to merge 1 commit into
base: main
Choose a base branch
from
+10 −0
Open

docs: add supported runners table to frontmatter reference #17361

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions docs/src/content/docs/reference/frontmatter.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -450,6 +450,16 @@ runs-on: ubuntu-latest # Defaults to ubuntu-latest (main job only)
timeout-minutes: 30 # Defaults to 20 minutes
```

**Supported runners for `runs-on:`**

| Runner | Status |
|--------|--------|
| `ubuntu-latest` | ✅ Default. Recommended for most workflows. |
| `ubuntu-24.04` / `ubuntu-22.04` | ✅ Supported. |
| `ubuntu-24.04-arm` | ✅ Supported. Linux ARM64 runner. |
| `macos-*` | ❌ Not supported. Docker is unavailable on macOS runners (no nested virtualization). See [FAQ](/gh-aw/reference/faq/#why-dont-agentic-workflows-support-macos-runners). |
Copy link

Copilot AI Feb 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The FAQ link target appears to be broken: there is no #why-dont-agentic-workflows-support-macos-runners section in docs/src/content/docs/reference/faq.md, so this anchor will 404. Either add that FAQ heading (so the slug exists) or change this link to an existing section/page that explains macOS runner limitations.

Suggested change
| `macos-*` | ❌ Not supported. Docker is unavailable on macOS runners (no nested virtualization). See [FAQ](/gh-aw/reference/faq/#why-dont-agentic-workflows-support-macos-runners). |
| `macos-*` | ❌ Not supported. Docker is unavailable on macOS runners (no nested virtualization). See [FAQ](/gh-aw/reference/faq/). |

Copilot uses AI. Check for mistakes.
| `windows-*` | ❌ Not supported. AWF requires Linux. |
Comment on lines +460 to +461
Copy link

Copilot AI Feb 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This row says macos-* is not supported because Docker is unavailable on macOS runners, but this repo includes an agentic workflow that runs on macos-latest and explicitly validates Docker (.github/workflows/smoke-macos-arm64.md). Please reconcile the docs with actual supported behavior (e.g., clarify that macOS is supported/experimental, or that only certain macOS runners are supported) and avoid stating Docker is unavailable if it's expected to work here.

Suggested change
| `macos-*` | ❌ Not supported. Docker is unavailable on macOS runners (no nested virtualization). See [FAQ](/gh-aw/reference/faq/#why-dont-agentic-workflows-support-macos-runners). |
| `windows-*` | ❌ Not supported. AWF requires Linux. |
| `macos-latest` (ARM64) | 🧪 Supported on GitHub-hosted macOS ARM runners with Docker available. See [FAQ](/gh-aw/reference/faq/#why-dont-agentic-workflows-support-macos-runners). |
| Other `macos-*` | ❌ Not supported. Older macOS runners do not provide the required Docker/nested virtualization capabilities. |
| `windows-*` | ❌ Not supported. Agentic Workflows do not currently support Windows runners. |

Copilot uses AI. Check for mistakes.

### Workflow Concurrency Control (`concurrency:`)

Automatically generates concurrency policies for the agent job. See [Concurrency Control](/gh-aw/reference/concurrency/).
Expand Down
Loading