Kimchi provides a GUI front end to manage KVM guests through libvirt.

Basic Operation

This is a (very) rough outline to get you up and running. You will need to go through the following steps:

  1. Add a Network adaptor (if you don't want the default virbr0 adaptor) and start it.
  2. In the Storage tab, add your iso to ISO storage area (see the known issue below)
  3. In the Templates tab, add a template for your VM specifying the Processor, Network Interfaces and Storage you will want your VM to have.
  4. In the Guests tab you should then be able to create a VM from one of the templates you have set up.

Known Issues

No Virtualization tab showing

In ClearOS, dnsmasq (DNS and DHCP server) binds to all IP's. This includes the libvirt virbr0 interface and it stops libvirt from starting. This behaviour needs to be changed. Create a file /etc/dnsmasq.d/libvirt and in it put:


If there are any other files in this folder with “bind-interfaces” in them, the “bind-interfaces” line should be removed or changed to “bind-dynamic”. Then try restarting dnsmasq and libvirt with:

systemctl restart dnsmasq libvirtd

If that does not work, reboot.

No permissions to run downloaded iso

When you download an iso into Kimchi, you won't have permission to run it. Either change the file ownership to qemu:qemu or make it world readable:

chown qemu:qemu /var/lib/kimchi/isos/*


chmod 0644 /var/lib/kimchi/isos/*

Tips and Tricks

VM Host (ClearOS) with only one NIC

If your server has only one NIC, you can still use Kimchi. In the Virtialization > Network tab, create a Macvtap interface and attach it to your ClearOS interface. Then use the Macvtap interface in your guests. Your guests will then pull a DHCP IP address from your DHCP server. The only limitation is that your host and guest machines cannot communicate directly, so, for example, your ClearOS host will not be able to ping any of its VM guests.

content/en_us/7_ug_kimchi.txt · Last modified: 2020/03/12 09:28 by