summaryrefslogtreecommitdiff
path: root/hurd/running/debian/qemu_image.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'hurd/running/debian/qemu_image.mdwn')
-rw-r--r--hurd/running/debian/qemu_image.mdwn59
1 files changed, 43 insertions, 16 deletions
diff --git a/hurd/running/debian/qemu_image.mdwn b/hurd/running/debian/qemu_image.mdwn
index c25b76ab..9984ac33 100644
--- a/hurd/running/debian/qemu_image.mdwn
+++ b/hurd/running/debian/qemu_image.mdwn
@@ -1,5 +1,4 @@
-[[!meta copyright="Copyright © 2011, 2012, 2014, 2016 Free Software Foundation,
-Inc."]]
+[//]: # ([[meta copyright="Copyright © 2011, 2012, 2014, 2016 Free Software Foundation, Inc."]])
[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
id="license" text="Permission is granted to copy, distribute and/or modify this
@@ -9,28 +8,56 @@ Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license
is included in the section entitled [[GNU Free Documentation
License|/fdl]]."]]"""]]
+[[!meta title="Debian's QEMU Image"
+
There is a QEMU image with [[Debian GNU/Hurd|debian]] pre-installed available
-as <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.tar.gz>.
+at <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.tar.gz>.
Usage:
-* Install qemu-kvm via your distros packages.
-* Download the debian image
- $ `wget https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.tar.gz`
-* Unpack it.
- $ `tar -xz < debian-hurd.img.tar.gz`
-* Run it
- $ `kvm -m 1G -drive cache=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22`
- # Optionally use --curses to keep your keyboard layout. If need be modprobe kvm_amd, kvm intel and kvm to get kvm support (which is much, much faster).
-* Login as root (the root password is empty)
-* set up a root password with passwd
+* Install qemu-kvm via your distribution's package manager (it might just be named qemu)
+* Download the image, unpack it, and run it:
+
+<!-- Code snippits embedded in lists are garbage. Do not remove this comment. -->
+
+ $ wget https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.tar.gz
+ $ tar -xz < debian-hurd.img.tar.gz
+ $ kvm -m 1G -drive cache=writeback,file=$(echo debian-hurd-*.img) -no-reboot -net user,hostfwd=tcp:127.0.0.1:2222-:22 -net nic,model=e1000
+
+* Log in as root (the root password is empty)
+* Set up a root password with `passwd`
+
+* update the system with `apt update && apt upgrade`
+
+* Log in as demo (the demo password is empty)
+* Set up a demo password with `passwd`
+
+* You can also create another non-root user with `adduser <username>`
+* and set the non-root user password with `passwd <username>`
+* and add the non-root user to the sudo group via `gpasswd -a <user> sudo`
+
+* logout via `logout`
+
+Optionally you may use `--curses` to keep your keyboard layout. If need be modprobe kvm_amd, kvm intel and kvm to get kvm support (which is much, much faster).
+
+Note that if you do not have a command named `kvm`, you can try something across the lines of:
+
+ $ qemu-system-i386 --enable-kvm -drive cche=writeback,file=$(echo debian-hurd-*.img) -net user,hostfwd=tcp:127.0.0.1:2222-:22 -net nic,model=e1000
+
+Or, if your machine does not allow for KVM acceleration, omit `--enable-kvm` from the command.
+
+
Please also read the README file: <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/README>
+<!-- It is unconventional, in wikis, to write external links like [...](http://...).
+ Usually a link to an external site should always be fully visible, but I think
+ people can understand where these lead, but revert if this is a bad idea.-->
+
If you have troubles extracting the image, you can use
-the gz version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.gz>,
-the zip version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.zip>,
-or even the plain version <https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img> (5GiB!)
+the [gz version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.gz),
+the [zip version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img.zip),
+or even the [plain version](https://cdimage.debian.org/cdimage/ports/latest/hurd-i386/debian-hurd.img) (5GiB!)
See the discussion about [[hurd/running/qemu/writeback_caching]].