docker-qemu/README.md

# tianon/qemu

```console
$ 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:native
```

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`.

By default, this image will use [QEMU's user-mode networking stack](https://wiki.qemu.org/Documentation/Networking#User_Networking_.28SLIRP.29), which means if you want ping/ICMP working, you'll likely need to also include something like `--sysctl net.ipv4.ping_group_range='0 2147483647'` in your container runtime settings.

The `native` variants for `amd64` only contain `qemu-system-x86_64` -- the non-`native` variants contain QEMU compiled for a variety of target CPUs.
add basic qemu readme 2014-09-20 07:58:07 +00:00			`# tianon/qemu`

Adjust README formatting 2020-12-03 18:33:02 +00:00			```console
			`$ 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' \`
Add explicit "native" variants These are explicitly targeting their native architectures -- for example, the amd64 build will only include `qemu-system-x86_64`, which leads to much smaller images for folks who just want to run a VM on its native platform. 2021-03-21 05:00:52 +00:00			`tianon/qemu:native`
Adjust README formatting 2020-12-03 18:33:02 +00:00			```
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`.
Add a note about ping/ICMP Closes #17 2020-12-03 18:34:32 +00:00
			By default, this image will use [QEMU's user-mode networking stack](https://wiki.qemu.org/Documentation/Networking#User_Networking_.28SLIRP.29), which means if you want ping/ICMP working, you'll likely need to also include something like `--sysctl net.ipv4.ping_group_range='0 2147483647'` in your container runtime settings.
Add explicit "native" variants These are explicitly targeting their native architectures -- for example, the amd64 build will only include `qemu-system-x86_64`, which leads to much smaller images for folks who just want to run a VM on its native platform. 2021-03-21 05:00:52 +00:00
			The `native` variants for `amd64` only contain `qemu-system-x86_64` -- the non-`native` variants contain QEMU compiled for a variety of target CPUs.