summaryrefslogtreecommitdiff
path: root/docs/macos.rst
blob: 84ff8192b5ca8a38ca5c77bf91275ad5f4324042 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
.. role:: since

=============
macOS support
=============

.. contents::

Libvirt works both as client (for most drivers) and server (for the
`QEMU driver <drvqemu.html>`__) on macOS.

:since:`Since 8.1.0`, the "hvf" domain type can be used to run
hardware-accelerated VMs on macOS via
`Hypervisor.framework <https://developer.apple.com/documentation/hypervisor>`__.
QEMU version 2.12 or newer is needed for this to work.


Installation
============

libvirt client (virsh), server (libvirtd) and development headers can be
installed from `Homebrew <https://brew.sh>`__:

::

   brew install libvirt


Running libvirtd locally
========================

The server can be started manually:

::

   $ libvirtd

or on system boot:

::

   $ brew services start libvirt

Once started, you can use virsh as you would on Linux.