Some tools to make life with qemu more comfortable

User Tools

Site Tools

Discrepancies of the definitions and conventions below will may be work, but are not supported!


qemu-init is designed with the following basics (requirements):

  1. All files which belongs to one dedicated virtual machine have to be in the same folder. It is possible to have multiple virtual machine in the same folder.
  2. The unique identifier <name> have to be unique for ALL registered machines. Recommendation: use alphabetical characters only!
  3. Using a bridged network - thus a bridge device must exists (default: br0).

For the virtual machines itself qemu-init is designed

  1. to run vm's in daemon mode (headless) with vnc enabled by default
  2. to access the monitor via tcp socket (local)


qemu-init is designed to have less dependencies as possible. The package comes with all required tools, except

  • iptools: the  ip  command is required for bridged networking
  • a bourne compatible shell (recommended is  bash , other shells may work too)
  • a working qemu installation (include required kernel modules)

As the last two should be trivial, the iptools package is the only real dependency (especially at *BSD).


Through the documentation we use some terms:

  • host is the machine where the virtual machines are running (hosted).
  • guest corresponds to the virtual machines which are running at host

Unique Identifier

Each virtual machine MUST have a unique identifier. The term <name> (with angle brackets) will be used as synonym of the unique identifier. The <name> is used to define which files belongs to one dedicated virtual machine. The <name> MUST

  • contain letters and numbers only - it MUST NOT contain a dot or minus sign!
  • NOT be longer than 40 chars
  • NOT end with the number '0'
  • be lower case unique for all registered guests

Recommended “best practice”: Use “<name>” as hostname (short, w/o domain) of the guest and as well as parameter of the qemu option  -name  (default)!

Guest config files

Each guest uses (could use) several config files (see Config files). All file which belongs to one guest starts with the <name> (in lower case letters) of the guest.

  • rc-file refers to the file  <name>-qemud.rc , default configuration file (required).
  • cfg-file refers to the file  <name>-qemu.cfg , the file for extended qemu user configuration (optional).

Attention!   qemu-init is the project name, qemud-init is a library!

Last modified: 2020/10/09 06:50

Page Tools