tyrola/virt-manager repository overview

⁠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.

⁠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"

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