virt-manager/INSTALL.md

53 lines
1.4 KiB
Markdown
Raw Normal View History

2016-12-26 18:46:58 +08:00
# 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)
2016-12-26 18:46:58 +08:00
To install the software into `/usr/local` (usually), you can do:
```sh
./setup.py install
2016-12-26 18:46:58 +08:00
```
To build an RPM, you can run:
```sh
./setup.py rpm
2016-12-26 18:46:58 +08:00
```
`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)
2016-12-26 18:46:58 +08:00
## Pre-requisite software
A detailed dependency list can be found in [virt-manager.spec](virt-manager.spec) file.
2016-12-26 18:46:58 +08:00
Minimum version requirements of major components:
- gettext >= 0.19.6
- python >= 3.4
- gtk3 >= 3.22
2016-12-26 18:46:58 +08:00
- libvirt-python >= 0.6.0
- pygobject3 >= 3.31.3
2016-12-26 18:46:58 +08:00
- libosinfo >= 0.2.10
- gtksourceview >= 3
2016-12-26 18:46:58 +08:00
On Debian or Ubuntu based distributions, you need to install the
2017-05-31 21:08:39 +08:00
`gobject-introspection` bindings for some dependencies like `libvirt-glib`
2016-12-26 18:46:58 +08:00
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.