# MacOS

MacOS is a self-hosted infrastructure app. MacOS runs a virtual macOS guest inside a Docker container with KVM acceleration, letting homelabbers self-host macOS desktop workloads on compatible hardware. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1117/macos

## Description

MacOS runs a virtual macOS guest inside a Docker container with KVM acceleration, letting homelabbers self-host macOS desktop workloads on compatible hardware.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

75/100 (Good), based on 5 of 5 factors.
- Maintained: 98 (last commit 54 days ago)
- Popular: 87 (21,709 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)
- Security check: 85 (no serious findings, CI)

## Links

- Docker Hub: https://hub.docker.com/r/dockurr/macos
- Unraid: https://ca.unraid.net/apps/macos-1n6cr6l1uomwjl?q=MacOS
- GitHub: https://github.com/dockur/macos

## Common questions

### Why is Docker Desktop unsupported on some systems?

Docker Desktop on Linux, macOS, and Windows 10 does not currently provide KVM access to containers, so the project marks it as unsupported.

### How do I complete the first-run installation?

After starting the container, open port 8006 in a browser, format the largest Apple Inc. VirtIO Block Media disk to APFS in Disk Utility, and choose Reinstall macOS. During setup, select Not now for Migration Assistant and Set Up Later for Apple ID.

### Which ports should I publish?

The example publishes 8006 for the web interface and 5900 over TCP and UDP. Expose those host ports if you need the same access.

### How do I keep the macOS install persistent?

Mount a host directory to the container's /storage path, such as ./macos:/storage in Compose or a -v flag in Docker CLI.

### What devices and capabilities are required for virtualization?

The container must be given /dev/kvm and /dev/net/tun, and the NET_ADMIN capability must be added. This is the setup shown in the Docker Compose and CLI examples.

---
Source: Our Local Host (https://ourlocalhost.com/app/1117/macos), the self-hosted and open-source app directory.
