Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Installing Kimchi & Wok on Ubuntu or Mint

Installing Kimchi & Wok

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

Get Packages


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



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


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


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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
You can’t perform that action at this time.