docker-qemu/README.md

# tianon/qemu

	touch /home/jsmith/hda.qcow2
	docker run -it --rm \
		--device /dev/kvm \
		--name qemu-container \
		-v /home/jsmith/hda.qcow2:/tmp/hda.qcow2 \
		-e QEMU_HDA=/tmp/hda.qcow2 \
		-e QEMU_HDA_SIZE=100G \
		-e QEMU_CPU=4 \
		-e QEMU_RAM=4096 \
		-v /home/jsmith/downloads/debian.iso:/tmp/debian.iso:ro \
		-e QEMU_CDROM=/tmp/debian.iso \
		-e QEMU_BOOT='order=d' \
		-e QEMU_PORTS='2375 2376' \
		tianon/qemu

Note: port 22 will always be mapped (regardless of the contents of `QEMU_PORTS`).

For supplying additional arguments, use a command of `start-qemu <args>`. For example, to use `-curses`, one would `docker run ... tianon/qemu start-qemu -curses`.

For UEFI support, [the `ovmf` package](https://packages.debian.org/sid/ovmf) is installed, which can be utilized most easily by supplying `--bios /usr/share/ovmf/OVMF.fd`.
add basic qemu readme 2014-09-20 07:58:07 +00:00			`# tianon/qemu`

long-form the qemu README for easier readability 2015-05-01 23:27:49 +00:00			`touch /home/jsmith/hda.qcow2`
			`docker run -it --rm \`
			`--device /dev/kvm \`
			`--name qemu-container \`
			`-v /home/jsmith/hda.qcow2:/tmp/hda.qcow2 \`
			`-e QEMU_HDA=/tmp/hda.qcow2 \`
			`-e QEMU_HDA_SIZE=100G \`
			`-e QEMU_CPU=4 \`
			`-e QEMU_RAM=4096 \`
			`-v /home/jsmith/downloads/debian.iso:/tmp/debian.iso:ro \`
			`-e QEMU_CDROM=/tmp/debian.iso \`
Add QEMU_BOOT parameter to tianon/qemu 2015-07-15 17:19:46 +00:00			`-e QEMU_BOOT='order=d' \`
Refactor start-qemu ports handling to allow for user-specified port mappings 2015-10-27 23:02:00 +00:00			`-e QEMU_PORTS='2375 2376' \`
long-form the qemu README for easier readability 2015-05-01 23:27:49 +00:00			`tianon/qemu`
Refactor start-qemu ports handling to allow for user-specified port mappings 2015-10-27 23:02:00 +00:00
			Note: port 22 will always be mapped (regardless of the contents of `QEMU_PORTS`).
Add some notes about additional arguments and about UEFI/OVMF 2016-11-03 00:32:16 +00:00
			For supplying additional arguments, use a command of `start-qemu <args>`. For example, to use `-curses`, one would `docker run ... tianon/qemu start-qemu -curses`.

			For UEFI support, [the `ovmf` package](https://packages.debian.org/sid/ovmf) is installed, which can be utilized most easily by supplying `--bios /usr/share/ovmf/OVMF.fd`.