virt-manager/INSTALL.md
Cole Robinson 5a6714715b INSTALL: Correctly document that we require pygobject >= 3.31.1
Signed-off-by: Cole Robinson <crobinso@redhat.com>
2022-02-20 12:31:52 -05:00

53 lines
1.4 KiB
Markdown

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