diff --git a/README.md b/README.md index 09fe4e4..143fec3 100644 --- a/README.md +++ b/README.md @@ -281,6 +281,23 @@ Examples (virtme-ng is started in graphical mode) ``` + - Run virtme-ng inside a docker container (using virtme-ng directly from the + source repository): +``` + $ docker run -it ubuntu:22.04 /bin/bash + # apt update + # echo 'debconf debconf/frontend select Noninteractive' | debconf-set-selections + # apt install --yes git qemu-kvm udev iproute2 busybox-static \ + coreutils python3-requests libvirt-clients kbd kmod file rsync zstd udev + # cd ~ + # git clone --recursive https://github.com/arighi/virtme-ng.git + # apt download linux-image-unsigned-6.5.0-14-generic # replace this with any other kernel + # apt download linux-modules-6.5.0-14-generic # replace this with any other kernel + # for f in *.deb; do dpkg -x $f .; done + # ./virtme-ng/vng -r boot/vmlinuz-6.5.0-14-generic -- uname -r + 6.5.0-14-generic +``` + Implementation details ====================== @@ -343,6 +360,14 @@ command when running make. Troubleshooting =============== + - Running virtme-ng instances inside docker: in case of failures/issues, + especially with stdin/stdout/stderr redirections, make sure that you have + `udev` installed in your docker image and run the following command before + using `vng`: +``` + $ udevadm trigger --subsystem-match --action=change +``` + - If you get permission denied when starting qemu, make sure that your username is assigned to the group `kvm` or `libvirt`: ```