dockur/macos
Macos
This project provides a containerized environment for running a full macOS desktop operating system. It utilizes a hardware-accelerated virtualization engine to execute the guest environment, allowing for the deployment and management of virtual machines through standard container orchestration tools.
The platform distinguishes itself by enabling direct hardware passthrough, which maps physical host disks, partitions, and USB controllers directly into the virtual machine for native driver access. It also supports advanced network integration, allowing the guest system to obtain its own unique IP address on the local network through bridging or macvlan configurations. Users interact with the virtualized desktop through a remote interface that streams the framebuffer directly to a web browser or VNC client.
Beyond core virtualization, the project includes comprehensive management tools for allocating CPU, memory, and storage resources. It facilitates data exchange between the host and guest systems by supporting the mounting of local directories directly into the virtual environment. The system is designed to be deployed as a container, with configuration options available for managing virtual hardware and network connectivity.
Features
- Virtualized Desktop Environments - Provides a containerized environment for running a full macOS desktop operating system with hardware acceleration.
- Virtual Machine Containers - Runs a full macOS desktop operating system inside a containerized virtual machine environment.
- Remote Desktop Infrastructure - Provides web-based and VNC remote access to virtualized desktop environments.
- Virtualization Platforms - Utilizes the QEMU virtualization engine to execute guest operating systems with hardware acceleration.
- Hardware Passthrough - Maps physical host disks and USB controllers directly into the virtual machine for native hardware access.
- Remote Desktop Environments - Enables remote interaction with the virtualized desktop through web-based and VNC streaming interfaces.
- Virtual Machine Management Tools - Manages virtual machine lifecycles and resource allocation using container orchestration tools.
- USB Passthrough - Allows the guest operating system to interact directly with physical USB hardware from the host.
- Hardware-Accelerated Hypervisors - Exposes host CPU and memory virtualization extensions to the guest for near-native performance.
- Virtual Screen Streaming - Streams the virtual machine framebuffer to a web browser for remote desktop interaction.
- Storage Management - Manages virtual storage by configuring disk sizes, custom locations, and physical partition attachments.
- Host-Guest Mounts - Mounts local host directories into the virtual environment for seamless file sharing.
- Hardware Resource Allocation - Allocates CPU, memory, and storage resources for virtualized guest environments.
- Host-to-Guest File Sharing - Mounts local host folders into the virtual environment for data synchronization.
- Virtualization Networking - Supports macvlan and bridge networking to provide the guest system with a unique local IP address.
- Bridge Networking Configurations - Integrates virtual machines into local networks using bridge and macvlan configurations.
- Network Connectivity Configurations - Configures network connectivity modes including macvlan, bridge, and DHCP for virtual machines.
- Virtualization Configuration - Allows configuration of CPU, memory, and storage resources for the virtualized guest environment.
