---
modeline: |
  vim: set ft=pandoc:
description: |
  The Qemu Packer builder is able to create KVM and Xen virtual machine images.
layout: docs
page_title: QEMU - Builders
sidebar_current: docs-builders-qemu
---

# QEMU Builder

Type: `qemu`

The Qemu Packer builder is able to create [KVM](http://www.linux-kvm.org) and
[Xen](http://www.xenproject.org) virtual machine images.

The builder builds a virtual machine by creating a new virtual machine from
scratch, booting it, installing an OS, rebooting the machine with the boot media
as the virtual hard drive, provisioning software within the OS, then shutting it
down. The result of the Qemu builder is a directory containing the image file
necessary to run the virtual machine on KVM or Xen.

## Basic Example

Here is a basic example. This example is functional so long as you fixup paths
to files, URLS for ISOs and checksums.

```json
{
  "builders": [
    {
      "type": "qemu",
      "iso_url": "http://mirror.raystedman.net/centos/6/isos/x86_64/CentOS-6.9-x86_64-minimal.iso",
      "iso_checksum": "af4a1640c0c6f348c6c41f1ea9e192a2",
      "iso_checksum_type": "md5",
      "output_directory": "output_centos_tdhtest",
      "shutdown_command": "echo 'packer' | sudo -S shutdown -P now",
      "disk_size": "5000M",
      "format": "qcow2",
      "accelerator": "kvm",
      "http_directory": "path/to/httpdir",
      "ssh_username": "root",
      "ssh_password": "s0m3password",
      "ssh_timeout": "20m",
      "vm_name": "tdhtest",
      "net_device": "virtio-net",
      "disk_interface": "virtio",
      "boot_wait": "10s",
      "boot_command": [
        "<tab> text ks=http://{{ .HTTPIP }}:{{ .HTTPPort }}/centos6-ks.cfg<enter><wait>"
      ]
    }
  ]
}
```

This is an example only, and will time out waiting for SSH because we have not
provided a kickstart file. You must add a valid kickstart file to the
"http_directory" and then provide the file in the "boot_command" in order for
this build to run. We recommend you check out the
[Community Templates](https://www.packer.io/community-tools.html#templates)
for a practical usage example.

Note that you will need to set `"headless": true` if you are running Packer
on a Linux server without X11; or if you are connected via ssh to a remote
Linux server and have not enabled X11 forwarding (`ssh -X`).

## Qemu Specific Configuration Reference

There are many configuration options available for the builder. In addition to
the items listed here, you will want to look at the general configuration
references for [ISO](#iso-configuration),
[HTTP](#http-directory-configuration),
[Floppy](#floppy-configuration),
[Boot](#boot-configuration),
[Shutdown](#shutdown-configuration),
[Communicator](#communicator-configuration)
configuration references, which are
necessary for this build to succeed and can be found further down the page.

### Optional:

@include 'partials/builder/qemu/Config-not-required.mdx'

## ISO Configuration

@include 'partials/common/ISOConfig.mdx'

### Required:

@include 'partials/common/ISOConfig-required.mdx'

### Optional:

@include 'partials/common/ISOConfig-not-required.mdx'

## Http directory configuration

@include 'partials/common/HTTPConfig.mdx'

### Optional:

@include 'partials/common/HTTPConfig-not-required.mdx'

## Floppy configuration

@include 'partials/common/FloppyConfig.mdx'

### Optional:

@include 'partials/common/FloppyConfig-not-required.mdx'

## Shutdown configuration

### Optional:

@include 'partials/common/shutdowncommand/ShutdownConfig-not-required.mdx'

## Boot Configuration

@include 'partials/common/bootcommand/VNCConfig.mdx'
@include 'partials/common/bootcommand/BootConfig.mdx'

### Optional:

@include 'partials/common/bootcommand/VNCConfig-not-required.mdx'
@include 'partials/common/bootcommand/BootConfig-not-required.mdx'

### Communicator Configuration

#### Optional:

@include 'partials/helper/communicator/Config-not-required.mdx'

### Troubleshooting

Some users have experienced errors complaining about invalid keymaps. This
seems to be related to having a `common` directory or file in the directory
they've run Packer in, like the packer source directory. This appears to be an
upstream bug with qemu, and the best solution for now is to remove the
file/directory or run in another directory.

Some users have reported issues with incorrect keymaps using qemu version 2.11.
This is a bug with qemu, and the solution is to upgrade, or downgrade to 2.10.1
or earlier.