From 56313450a94816009a4ff5ec5188c3fc71bc0668 Mon Sep 17 00:00:00 2001 From: Brian Candler Date: Fri, 20 May 2016 18:01:41 +0100 Subject: [PATCH] Headless documentation (#3557) * Add some notes about qemu headless mode Partly resolves #3530 --- CHANGELOG.md | 2 +- website/source/docs/builders/qemu.html.md | 7 +++++++ 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e4d386eaf..702602453 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -538,7 +538,7 @@ BUG FIXES: * builder/parallels: Disconnect cdrom0 [GH-1605] * builder/qemu: Don't use `-redir` flag anymore, replace with `hostfwd` options. [GH-1561] - * builder/qmeu: Use `pc` as default machine type instead of `pc-1.0`. + * builder/qemu: Use `pc` as default machine type instead of `pc-1.0`. * providers/aws: Ignore transient network errors. [GH-1579] * provisioner/ansible: Don't buffer output so output streams in. [GH-1585] * provisioner/ansible: Use inventory file always to avoid potentially diff --git a/website/source/docs/builders/qemu.html.md b/website/source/docs/builders/qemu.html.md index 015845551..cdacaf3d3 100644 --- a/website/source/docs/builders/qemu.html.md +++ b/website/source/docs/builders/qemu.html.md @@ -78,6 +78,10 @@ In addition to the options listed here, a [communicator](/docs/templates/communicator.html) can be configured for this builder. +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`). + ### Required: - `iso_checksum` (string) - The checksum for the OS ISO file. Because ISO @@ -167,6 +171,9 @@ builder. launching a GUI that shows the console of the machine being built. When this value is set to true, the machine will start without a console. + You can still see the console if you make a note of the VNC display + number chosen, and then connect using `vncviewer -Shared :` + - `http_directory` (string) - Path to a directory to serve using an HTTP server. The files in this directory will be available over HTTP that will be requestable from the virtual machine. This is useful for hosting