# sickcodes/Docker-OSX

Run macOS VM in a Docker! Run near native OSX-KVM in Docker! X11 Forwarding! CI/CD for OS X Security Research! Docker mac Containers.

Repository: https://github.com/sickcodes/Docker-OSX
Canonical: https://ross.abutalabs.com/products/docker-osx
Homepage: https://hub.docker.com/r/sickcodes/docker-osx
Language: Shell
License: GPL-3.0
License Family: copyleft
Topics: docker, osx, macos, x11, container, kvm, osx-kvm, docker-osx, os, x
Last push: 2025-11-11T05:23:57+00:00

## Health v2 (maintenance only)
Score: 55/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 51, release rhythm 35, longevity 100
- inputs: {"age_days": 2281, "days_push": 295, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 52887, forks 2891 (observed 2026-08-28T04:12:12.064160+00:00)

## What it is
Docker-OSX is a Docker-based tool that runs macOS virtual machines with near-native performance using KVM and QEMU, built on top of OSX-KVM and OpenCore. It supports X11 forwarding, USB passthrough, and is aimed at macOS security research and CI/CD workflows on Linux and Windows hosts.

## Use cases
- run macOS in a docker container on linux
- macos security research malware analysis
- spin up a macos vm for ci/cd testing
- use imessage or iphone usb passthrough in a vm
- test software on macos without a mac
- run near-native osx kvm in docker

## When to choose
- you need a disposable or scriptable macOS environment on Linux/Windows hardware
- you want macOS VMs for security research or CI pipelines
- you need X11 forwarding or USB passthrough to the guest

## When to avoid
- you need a licensed, supported macOS environment for production workloads
- your host lacks KVM or nested virtualization support
- you need GPU-accelerated macOS graphics or official Apple hardware compatibility

## Facets
- artifact type: application
- maturity: active
- function: container-runtime, security, developer-tools, simulation
- domain: security, operating-systems, developer-tools, apple-ecosystem
- platform: cli, windows
- tags: macos-vm, kvm, qemu, osx-kvm, x11-forwarding, virtualization, hackintosh, security-research, ci-cd, containers, linux, docker

## Member repositories
- sickcodes/Docker-OSX (main) score 55

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:12.064160+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:19:35.006123+00:00, confidence not recorded.
  - readme: https://github.com/sickcodes/Docker-OSX (fetched 2026-08-28T04:12:12.064160+00:00, sha 0bb9999335dc)
  - homepage: https://hub.docker.com/r/sickcodes/docker-osx (fetched 2026-08-28T18:07:45.164510+00:00, sha 89432fa9cc24)
  - site_page: https://docs.docker.com/docker-hub (fetched 2026-08-28T18:07:45.172905+00:00, sha caaa18892709)
  - site_page: https://www.docker.com/docs (fetched 2026-08-28T18:07:45.174878+00:00, sha aeada2272712)
  - site_page: https://www.docker.com/company (fetched 2026-08-28T18:07:45.176680+00:00, sha 05ab59b2bc29)
- Data as of 2026-08-30T08:39:29.467469+00:00.