Skip to content

Doc: Add document for supported macos versions #390

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
wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Doc: Add document for supported macos versions #390

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2852d00
make: change macosx minimum version to 13.0
vyasgun Oct 15, 2025
c7ba078
doc: Added a document outlining the supported hosts for vfkit
vyasgun Oct 15, 2025
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
2 changes: 1 addition & 1 deletion Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.PHONY: all build clean test test-unit test-integration

GIT_VERSION ?= $(shell git describe --always --dirty)
CGO_CFLAGS=-mmacosx-version-min=11.0
CGO_CFLAGS=-mmacosx-version-min=13.0
VERSION_LDFLAGS=-X github.com/crc-org/vfkit/pkg/cmdline.gitVersion=$(GIT_VERSION)

all: build
Expand Down
18 changes: 18 additions & 0 deletions doc/supported_platforms.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# Supported Host Platforms

`vfkit` is a macOS-only virtualization tool that uses Apple's Virtualization framework to manage virtual machines.

## Host Requirements

The project aims to support the most recent macOS major version at all times, along with the two previous major versions. Support for the oldest supported version will be dropped three years after its release date or when Apple discontinues support, whichever occurs first.

**macOS 14.0 or later** is recommended and fully supported. CI tested on:
- macOS 14 (Sonoma) - CI tested on Apple Silicon
- macOS 15 (Sequoia) - CI tested on Apple Silicon
- macOS 26 (Tahoe) - CI tested on Apple Silicon
Comment on lines +10 to +12
Copy link

@coderabbitai coderabbitai bot Oct 16, 2025

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Fix incorrect macOS version in CI coverage list.

There’s no macOS 26 release; this looks like a typo. Update the entry to the actual major version you test (likely macOS 16) so we don’t publish misleading support information.

🧰 Tools
🪛 LanguageTool

[grammar] ~10-~10: There might be a mistake here.
Context: ...14 (Sonoma) - CI tested on Apple Silicon - macOS 15 (Sequoia) - CI tested on Apple ...

(QB_NEW_EN)

[grammar] ~11-~11: There might be a mistake here.
Context: ...5 (Sequoia) - CI tested on Apple Silicon - macOS 26 (Tahoe) - CI tested on Apple Si...

(QB_NEW_EN)

🤖 Prompt for AI Agents 
In doc/supported_platforms.md around lines 10 to 12, the third entry incorrectly
lists "macOS 26 (Tahoe)"; change that line to the correct major release you test
(replace with "macOS 16 (Tahoe)" or the actual release name you validate in CI)
so the CI coverage list is accurate, and ensure the line formatting matches the
other entries.


- **macOS 13.0** may work but is not officially supported. Integration tests currently run on macOS 13, but this GitHub Actions runner will be deprecated soon. See [GitHub’s announcement](https://github.blog/changelog/2025-07-11-upcoming-changes-to-macos-hosted-runners-macos-latest-migration-and-xcode-support-policy-updates/#macos-13-is-closing-down).

**Architectures:**
- Intel x86_64
Copy link
Collaborator

@cfergeau cfergeau Oct 15, 2025

Choose a reason for hiding this comment

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

Need to decide if we want to start deprecating this, or if we wait for apple to officialy drop support.
Just food for thought, no changes needed in this PR.

- Apple Silicon
Loading