{"id":37109409,"url":"https://github.com/mac-vz/macvz","last_synced_at":"2026-01-14T13:00:44.211Z","repository":{"id":37658706,"uuid":"461189207","full_name":"mac-vz/macvz","owner":"mac-vz","description":"macOS Virtualization for linux","archived":false,"fork":false,"pushed_at":"2025-02-11T01:17:41.000Z","size":4685,"stargazers_count":89,"open_issues_count":15,"forks_count":6,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-11T02:24:27.030Z","etag":null,"topics":["go","golang","linux","macos","virtualization","vm"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mac-vz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-19T12:45:05.000Z","updated_at":"2025-02-11T01:17:45.000Z","dependencies_parsed_at":"2022-07-14T22:46:48.293Z","dependency_job_id":null,"html_url":"https://github.com/mac-vz/macvz","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/mac-vz/macvz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-vz%2Fmacvz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-vz%2Fmacvz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-vz%2Fmacvz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-vz%2Fmacvz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mac-vz","download_url":"https://codeload.github.com/mac-vz/macvz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mac-vz%2Fmacvz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28420815,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:47:48.104Z","status":"ssl_error","status_checked_at":"2026-01-14T10:46:19.031Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","linux","macos","virtualization","vm"],"created_at":"2026-01-14T13:00:41.686Z","updated_at":"2026-01-14T13:00:44.188Z","avatar_url":"https://github.com/mac-vz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Go Report Card](https://goreportcard.com/badge/mac-vz/macvz)](https://goreportcard.com/report/github.com/mac-vz/macvz)\n[![Codacy grade](https://img.shields.io/codacy/grade/40eae50295114eabba6b12b7372bed81?\u0026logo=codacy)](https://www.codacy.com/gh/mac-vz/macvz/dashboard?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=mac-vz/macvz\u0026amp;utm_campaign=Badge_Grade)\n[![GitHub](https://img.shields.io/github/license/mac-vz/macvz?color=brightgreen)](https://github.com/mac-vz/macvz/blob/main/LICENSE)\n\n# MACVZ\n\nThis project is inspired by and a rewrite of lima-vm.\n\nThe major difference is macvz uses macOS new [Virtualization API](https://developer.apple.com/documentation/virtualization?language=objc) instead of QEMU for spinning up VM's.\n\n# Requirements\n- Higher or equal to macOS monterey (12.2)\n- Golang\n\n# Getting Started\n## Installation via Homebrew\n- Run `brew install mac-vz/tap/macvz` to install macvz\n\n## Installation via source\n- Run `make all` to compile and build binary\n- Run `make install` to install the binary to /usr/local\n\n## Using macvz as a alternate for Docker Desktop\nTo start a Docker VM, run the following command\n```\nmacvz start https://raw.githubusercontent.com/mac-vz/macvz/main/examples/docker.yaml\n```\n\nExecute the following command in macOS host to update docker.sock location\n```\nexport DOCKER_HOST=unix://${HOME}/.macvz/docker/sock/docker.sock\n```\n\nThat's it !! \n\n\n## Other macvz commands\n\nTo get shell access to a running VM,\n```\nmacvz shell docker\n```\n\nTo stop a running VM,\n```\nmacvz stop docker\n```\n\n# Features\n- Ability to start, stop and shell access\n- Filesystem mounting using virtfs (See the performance report below)\n- Automatic Port forwarding\n- Custom DNS Resolution (like host.docker.internal)\n\n# Planned\n- Support for commands like list, delete, pause, resume\n- Support for different linux distros\n\n# Performance Summary\n\n## Summary of filesystem performance with colima\n\nThe following table contains result summary of some different workloads tested against macvz and colima\n\n### Summary for IOPS (Input Ouput Per Second)\n| Workload            | Summary                            | macvz   | colima |\n|---------------------|------------------------------------|---------|--------|\n| Sequential Reads    | macvz handles 8x higher operations | 620K    | 77K    |\n| Random Reads        | macvz handles 3x higher operations | 82K     | 25K    |\n| Random Reads/Writes | macvz handles 3x higher operations | 37K/12K | 14K/4K |\n| Sequential writes   | macvz performs almost equally      | 37K     | 38K    |\n| Random writes       | macvz performs almost equally      | 22K     | 30K    |\n\n### Summary for Bandwidth (Maximum amount of data transmitted)\n| Workload            | Summary                       | macvz      | colima    |\n|---------------------|-------------------------------|------------|-----------|\n| Sequential Reads    | macvz handles 8x more data    | 2500MB     | 306MB     |\n| Random Reads        | macvz handles 3x more data    | 320MB      | 98MB      |\n| Random Reads/Writes | macvz handles 3x more data    | 140MB/50MB | 60MB/20MB |\n| Sequential writes   | macvz performs almost equally | 145MB      | 150MB     |\n| Random writes       | macvz performs almost equally | 90MB       | 110MB     |\n\nCheck out Wiki page [Why use virtualization framework](https://github.com/mac-vz/macvz/wiki/Why-use-macOS-virtualization-framework-%3F) for detailed information\n\n# Project Status\n⚠️ The project is still in early stage development and may introduce breaking changes.\n\n# Supporters\n\n[\u003cimg src=\"https://uploads-ssl.webflow.com/5ac3c046c82724970fc60918/5c019d917bba312af7553b49_MacStadium-developerlogo.png\" style=\"max-height: 150px;width: 150px\"/\u003e](https://macstadium.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmac-vz%2Fmacvz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmac-vz%2Fmacvz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmac-vz%2Fmacvz/lists"}