Skip to content

BirknerAlex/virt-manager-macos

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

virt-manager on macOS

This is a Docker container for running virt-manager on macOS with the help of Docker and Xquartz. It uses X11 forwarding to display the GUI on the host. Running virt-manager on macOS is not officially supported by the virt-manager project. This is a workaround to get it running on macOS.

It also supports SSH connections to remote hosts via GPG agent forwarding, e.g. using a Yubikey.

There were some packages on homebrew, but they are outdated and not working anymore. This is why I created this Docker container which is based on the latest virt-manager version available on Fedora.

The pre-build container is available on Docker Hub: https://hub.docker.com/r/tyrola/virt-manager It is available for x86_64 and arm64 (Apple Silicon) architectures.

virt-manager usage example

Requirements

  • Docker Desktop for Mac
  • XQuartz

Installation

  1. Install XQuartz via Homebrew or download from https://www.xquartz.org/
brew install --cask xquartz
  1. Install Docker Desktop for Mac via Homebrew or download from https://www.docker.com/products/docker-desktop
brew install --cask docker

Preparation

  1. Open XQuartz
    • Open settings
    • Chose Security tab
    • Enable "Allow connections from network clients"

XQuartz Settings Screenshot

  1. Allow localhost connection to X11
xhost +localhost

Running

Start the container with following commands:

# Create Docker volume for storing virt-manager config
docker volume create virt-manager-config

# Run container
docker run -t -i --rm \
  -v virt-manager-cfg:/home/default/.config/:rw \
  --mount type=bind,src=/run/host-services/ssh-auth.sock,target=/run/host-services/ssh-auth.sock \
  --name virt-manager \
   tyrola/virt-manager:latest

About

Running virt-manager on macOS with Docker

Resources

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published