How to install Kimchi in Ubuntu 18.04


In this guide, we will be making our own Hypervisor in Ubuntu 16.04 by installing KVM (Kernel-based Virtual Machine) as well as Kimchi, which is a free, open-source web-based virtualization management platform so we can manage our hypervisor easily through the web browser.

You can find more info on Kimchi here

Installing kvm
Connect to your server as the admin user via SSH.

ssh [email protected]

Update and upgrade your web server

sudo apt update && sudo apt upgrade -y

Install KVM and all dependencies required for Kimchi and Wok

sudo apt install qemu qemu-kvm libvirt-bin python-paramiko python-pil novnc python-libvirt python-ethtool python-ipaddr python-guestfs libguestfs-tools spice-html5 spice-html5 python-magic keyutils libnfsidmap2 libtirpc1 nfs-common rpcbind python-configobj python-parted -y

Note: If you receive an error about packages not found
You must enable the Universe Repository by running.

sudo add-apt-repository universe

Verify the kvm installation

$ kvm-ok

This is what you should see if KVM is supported
INFO: /dev/kvm exists
KVM acceleration can be used

Installing Kimchi:

sudo apt install nginx -y



Installing dependencies:

sudo dpkg -i wok-2.5.0-0.noarch.deb

sudo apt install -f -y

sudo dpkg --ignore-depends=python-imaging -i kimchi-2.5.0-0.noarch.deb

#reboot here
sudo shutdown -r now

#If you have UFW enabled please add the port
sudo ufw allow 8001/tcp

Fixing Problem with Kimchi Package Dependancies.

Remove python-imaging from the Kimchi dependancies, this was replaced with Python-pil and is no longer needed and must be removed to avoid the apt command from uninstalling Kimchi due to unmet dependancies.

to do this you must edit the /var/lib/dpkg/status file and find the line Package: kimchi , under this you must remove the python-imaging or rename it to python-pil in the Depends: clause as shown below

Package: kimchi
Status: install ok installed
Priority: optional
Section: base
Maintainer: Aline Manera [email protected]
Architecture: all
Version: 2.5.0
Depends: wok (>= 2.1.0), python-imaging, python-configobj, novnc, python-jsonschema (>= 1.3.0), python-libvirt, gettext, libvirt-bin, nfs-common, qemu-kvm, python-parted, python-psutil (>= 0.6.0), python-ethtool, sosreport, python-ipadd$
Description: Kimchi web application
Build-Depends: xsltproc,

Now open the web interface on

You should see the following
Kimchi Login
Now lets create our first VM, we need to log in using your normal ubuntu username and password.
For testing we will download an Ubuntu Server image to the /var/lib/kimchi/isos directory which is the default path to the ISO repository

cd /var/lib/kimchi/isos

sudo wget

Now from the web interface we go to Virtualization > Templates > + Add Template

In this case i am selecting, the 16.04.2 Template and then click on Create this should add a new template as shown below
Kimchi Template

Feel free to add more ram, CPU, disk space as desired using the actions > edit button, at this point, it is just a template and not yet a vm.

Now we will create a vm using this template.

From the web interface we go to Virtualization > Guests > + Add Guest

Then we choose the VM Name and the template to use and hit create.

Important Note: Do not include any spaces in your VM name or you will be unable to start your VM.

Kimchi Add Guest

Once this is done, it is time to start your VM by pressing the Actions Menu > Start option

That's it you now have a working Ubuntu VM running, you can press the view console link to access your VM's console.

Kimchi VM

Optional Change Port to 443:

Change the port in the Nginx Config

sudo nano /etc/nginx/conf.d/wok.conf

Look for the following line

listen ssl;

Change it to

listen ssl;

Also locate inside of location / config

proxy_redirect https://$host:8001/;

Change this to

proxy_redirect https://$host:443/;

Change the port in the Wok config

sudo nano /etc/wok/wok.conf

Uncomment the following line

#proxy_port = 8001

Change it to

proxy_port = 443

If you have UFW enabled please add the port

sudo ufw allow 443/tcp

Restart Wok and Nginx

sudo service wokd restart
sudo service nginx restart

That is it now you can open the web interface on


Problems you may encounter :

Fix Bug with Template creation with Ubuntu 18.04 Template

This is a bug in the current stable release that has not yet been fixed, you will see the error below when this occurs.

KCHTMPL0020E: Unable to create template due error: KCHIMG0001E: Error probing image OS information: part_list: parted print: /dev/sda: Warning: The driver descriptor says the physical block size is 2048 bytes, but Linux says it is 512 bytes.

Manual Fix

Step 1

Edit the file /usr/lib/python2.7/dist-packages/wok/plugins/kimchi/model/

Search for the line:


Replace with


Step 2

Search for the line:

if ISO_TYPE in ftype:

Replace with
Note:(Empty characters are important)

        iscdrom = [t for t in ISO_TYPE if t in ftype]
        if iscdrom:


replace file with patched on from github

sudo wget -q -O /usr/lib/python2.7/dist-packages/wok/plugins/kimchi/model/ 

reboot here

sudo shutdown -r now

Thats it, you should now be able to use Ubuntu 18.04 templates