summaryrefslogtreecommitdiff
path: root/INSTALL.md
blob: e931d452399c0a1c5e83299dec3c9055b52788d9 (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
45
46
47
48
49
50
51
52
# Basic Install

For starters, if you just want to run `virt-manager/virt-install` to test out
changes, it can be done from the source directory:
```sh
./virt-manager
```

For more details on that, see [CONTRIBUTING.md](CONTRIBUTING.md)


To install the software into `/usr/local` (usually), you can do:
```sh
./setup.py install
```

To build an RPM, you can run:
```sh
./setup.py rpm
```

`setup.py` generally has all the build and install commands, for more info see:

   - `./setup.py --help-commands`
   - `./setup.py install --help`
   - [Python Standard Build and Install](https://docs.python.org/3/install/#standard-build-and-install)


## Pre-requisite software

A detailed dependency list can be found in [virt-manager.spec](virt-manager.spec) file.

Minimum version requirements of major components:

   - gettext >= 0.19.6
   - python >= 3.4
   - gtk3 >= 3.22
   - libvirt-python >= 0.6.0
   - pygobject3 >= 3.31.3
   - libosinfo >= 0.2.10
   - gtksourceview >= 3

On Debian or Ubuntu based distributions, you need to install the
`gobject-introspection` bindings for some dependencies like `libvirt-glib`
and `libosinfo`. Look for package names that start with `'gir'`, for example
`gir1.2-libosinfo-1.0`.


## Optional software

`virt-manager` can optionally use [libguestfs](http://libguestfs.org/)
for inspecting the guests.  For this, `python-libguestfs` >= 1.22 is needed.