Installing Kimchi & Wok on Ubuntu or Mint

installing_kimchi_wok.md

Installing Kimchi & Wok

I'm using Linux Mint 19.1 Tessa, this should work on Ubuntu Bionic and compatible variants.

Get Packages

wget https://kimchi-project.github.io/gingerbase/downloads/latest/ginger-base.noarch.deb
wget https://github.com/kimchi-project/kimchi/releases/download/2.5.0/kimchi-2.5.0-0.noarch.deb
wget https://github.com/kimchi-project/kimchi/releases/download/2.5.0/wok-2.5.0-0.noarch.deb

Install Packages

sudo apt update && sudo apt upgrade -y

sudo apt install -y                          \
    fonts-font-awesome gettext git keyutils  \
    libguestfs-tools libnfsidmap2 libtirpc1  \
    libvirt-bin logrotate nfs-common nginx   \
    novnc open-iscsi openssl python-apt      \
    python-cheetah python-cherrypy3          \
    python-configobj python-ethtool          \
    python-guestfs python-ipaddr             \
    python-jsonschema python-ldap            \
    python-libvirt python-lxml               \
    python-m2crypto python-magic             \
    python-pam python-paramiko python-parted \
    python-pil python-psutil qemu qemu-kvm   \
    rpcbind sosreport spice-html5 websockify \
    ebtables dnsmasq

Install

Wok

sudo dpkg -i wok-2.5.0-0.noarch.deb
sudo apt install -f -y

Ginger-Base

sudo dpkg -i ginger-base.noarch.deb
sudo apt install -f -y

Kimchi

Kimchi needs to be installed without python-imaging, because it was replaced with python-pil.

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

Find python-imaging under the Package: kimchi section in /var/lib/dpkg/status and replace it with python-pil. You can use this sed to do it automagically.

sudo sed -i 's/python-imaging, python-configobj/python-pil, python-configobj/' /var/lib/dpkg/status

Finish the install.

sudo apt install -f -y

If you have Uncomplicated Firewall (UFW) installed, add this rule.

sudo ufw allow 8001/tcp

Kimchi Config

Edit your /etc/kimchi/template.conf.

Find pool = and path = , uncomment and change them to the pool name and path you set above.

Mine would be:

pool = default
path = /dvr/virtualmachines

Finish Up

Reload systemctl daemon, enable wokd and libvirtd and start them.

sudo systemctl daemon-reload
sudo systemctl enable wokd
sudo systemctl restart wokd
sudo systemctl enable libvirtd
sudo systemctl restart libvirtd

For whatever reason I had to reboot at this point.

sudo reboot

Browse to: https://localhost:8001

Login with your regular server credentials.