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:

  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. The file <name>-qemu-rc is the core file and HAVE TO exist.
  4. qemu-init uses the folder  /etc/qemu/  (the common default of qemu) for config files shared between different tools

For the virtual machines itself qemu-init is designed

  1. to use bridged network connection(s)
  2. to run in daemon mode (headless) with vnc enabled by default
  3. 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).

Name Conventions


The term host is the machine where the virtual machines are running (hosted).


The term guest corresponds to the virtual machines itself.

Unique Identifier

Each virtual machine MUST have a unique identifier. The term <name> (include the angle brackets) will be used as synonym of the unique identifier. It MUST NOT contain a dot or minus sign. The <name> is used to define which files belongs to one dedicated virtual machine.

Use “<name>” as hostname (short, w/o domain) of the guest system and as well as parameter of the qemu option  -name  (which is the value of the variable NAME in  <name>-qemu.rc )1) too!

Example: All files which belongs to one dedicated virtual machine will be identified by the unique identifier <name>, like

         <name>-qemu.rc   - basic configuration file of the qemu virtual machine <name> (required)
         <name>-user.cfg  - default file name for individual config settings
         <name>-qemu.pid  - pidfile of the virtual machine (created and removed automatically)


The term rc-file refers to the file  <name>-qemu.rc  (see Config files).


The term cfg-file refers to the file  <name>-user.cfg . This is the default file name for extended user configuration of the virtual machine.

Last modified: 2020/01/30 18:50

Page Tools