/qemu-openrc

OpenRC init script for QEMU/KVM (for Gentoo and Alpine Linux)

Primary LanguageShellMIT LicenseMIT

OpenRC runscript for QEMU

This is (opinionated) OpenRC runscript for QEMU virtual machines.

You don’t need libvirt and its awful XML configs to use QEMU/KVM!

Requirements

  • OpenRC

  • Bash or Busybox’s ash (should work also with other POSIX shells)

  • socat

  • Linux kernel with virtio drivers

    CONFIG_HW_RANDOM_VIRTIO=y
CONFIG_SCSI_VIRTIO=y
CONFIG_VIRTIO=y
CONFIG_VIRTIO_BALLOON=y
CONFIG_VIRTIO_NET=y
CONFIG_VIRTIO_PCI=y

Installation

Alpine Linux

Install package qemu-openrc:

apk add qemu-openrc

Manually

  1. Install socat:

    emerge -av net-misc/socat  # on Gentoo
apk add socat  # on Alpine

  2. Clone this repository and jump in:

    git clone https://github.com/jirutka/qemu-openrc.git
cd qemu-openrc

  3. Install runscript, example config and qemush utility:

    make install

    You may use standard GNU variables such as DESTDIR, prefix, bindir… to specify the target directories.

How to configure a new VM

  1. Symlink runscript qemu for your new VM named jarvis:

    cd /etc/init.d
ln -s qemu qemu.jarvis

  2. Configure your new VM:

    cd /etc/conf.d
cp qemu qemu.jarvis
vim qemu.jarvis

  3. Start your new VM:

    rc-service qemu.jarvis start

License

This project is licensed under MIT License.