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

Merged
merged 2 commits into from
Nov 28, 2025
Merged

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
8b1710a
make: change macosx minimum version to 13.0
vyasgun Oct 15, 2025
9dbe7ef
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
23 changes: 23 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,23 @@
# 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 Testing

The project is tested on:
- macOS 14 (Sonoma) - Apple Silicon
- macOS 15 (Sequoia) - Apple Silicon
- macOS 15 (Sequoia) - Intel x86_64
- macOS 26 (Tahoe) - Apple Silicon

Integration tests with virtualization are run on **macos-15-intel** runners, as virtualization is not supported on Apple Silicon runners in GitHub Actions. These Intel runners will be deprecated by August 2027. See: [actions/runner-images#13045](https://github.com/actions/runner-images/issues/13045)
## Supported 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 (arm64)
Loading