https://github.com/cleafy/sxkdvm

SXKDVM - OSX Docker KVM / Run an OSX KVM virtual machine inside a Docker container.
https://github.com/cleafy/sxkdvm

docker docker-container kvm macosx osx osx-kvm osx-virtual-machine

Last synced: 4 days ago
JSON representation

SXKDVM - OSX Docker KVM / Run an OSX KVM virtual machine inside a Docker container.

• Host: GitHub
• URL: https://github.com/cleafy/sxkdvm
• Owner: Cleafy
• Created: 2017-05-18T16:59:47.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2017-06-15T14:42:28.000Z (over 7 years ago)
• Last Synced: 2024-12-28T11:09:55.155Z (11 days ago)
• Topics: docker, docker-container, kvm, macosx, osx, osx-kvm, osx-virtual-machine
• Language: Shell
• Homepage:
• Size: 195 KB
• Stars: 874
• Watchers: 42
• Forks: 87
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
(Research project)

# OSX Docker KVM

Run an OSX KVM virtual machine inside a Docker container.

This project permits to run an OSX virtual machine (KVM) inside a Docker container.

# Run the Image

To execute the container, you need a working `mac_hdd-backing.img`. You can obtain one with [OSX-KVM project](https://github.com/kholia/OSX-KVM). After that, you can mount the backing storage with the Docker command line and pass the KVM device.

    docker run --device /dev/kvm:/dev/kvm -v $PWD/backing:/backing -p 2222:2222 -p 5900:5900 -p 5800:5800 cleafy/sxkdvm

To persist the changes export the snapshot storage somewhere with `-v $PWD/snapshot:/snapshot`.

# Exposed Ports

This VM exposes an ssh connection at `2222` and a VNC server at `5900,5800` ports.

It is possible to access the VM with the following command:

    ssh appleuser@localhost -p 2222

# Performance Considerations

The environment uses automatic [copy-on-write](https://en.wikibooks.org/wiki/QEMU/Images#Copy_on_write) images to provide seamless integration with [Docker layered file system](https://docs.docker.com/engine/userguide/storagedriver/imagesandcontainers/). The mechanism mentioned above permits to obtain acceptable performance when running multiple VMs without hogging the storage.

Furthermore, this container uses hardware virtualization technologies, like VT-X or AMD-V, to achieve almost native performance.