From 7ed0bd42ade0cff3c726e5d05ad6dc846cb6a3b6 Mon Sep 17 00:00:00 2001
From: Martin Wimpress <304639+flexiondotorg@users.noreply.github.com>
Date: Sun, 21 Apr 2024 11:50:09 +0100
Subject: [PATCH] Created 02 - Create Linux virtual machines (markdown)

---
 02-‐-Create-Linux-virtual-machines.md | 76 +++++++++++++++++++++++++++
 1 file changed, 76 insertions(+)
 create mode 100644 02-‐-Create-Linux-virtual-machines.md

diff --git a/02-‐-Create-Linux-virtual-machines.md b/02-‐-Create-Linux-virtual-machines.md
new file mode 100644
index 0000000..e4e7826
--- /dev/null
+++ b/02-‐-Create-Linux-virtual-machines.md
@@ -0,0 +1,76 @@
+The `quickget` tool is provide as part of Quickemu and it's purpose is to automatically download operating system images and create an optimised virtual machine configuration.
+
+`quickget -h` will produce a list of all operating systems it supports, including 100s of Linux distribution editions, all the BSDs, macOS,   Windows, FreeDOS and many others.
+
+# Automatically create Linux guests 🐧
+
+Here's an example of how to create and run an Ubuntu guest virtual machine, the process is much the same for any other Linux distribution.
+
+``` shell
+quickget ubuntu 22.04
+quickemu --vm ubuntu-22.04.conf
+```
+
+-   Complete the installation as normal.
+-   Post-install:
+    -   Install the SPICE agent (`spice-vdagent`) in the guest to enable
+        copy/paste and USB redirection
+        -   `sudo apt install spice-vdagent`
+    -   Install the SPICE WebDAV agent (`spice-webdavd`) in the guest to
+        enable file sharing.
+        -   `sudo apt install spice-webdavd`
+
+## Ubuntu daily-live images
+
+`quickget` can also download/refresh daily-live images via `zsync` for Ubuntu developers and testers.
+
+``` shell
+quickget ubuntu daily-live
+quickemu --vm ubuntu-daily-live.conf
+```
+
+You can run `quickget ubuntu daily-live` to refresh your daily development image as often as you like, it will even automatically
+switch to a new series.
+
+## Ubuntu flavours
+
+All the official Ubuntu flavours are supported, just replace `ubuntu` with your preferred flavour.
+
+-   `edubuntu` (Edubuntu)
+-   `kubuntu` (Kubuntu)
+-   `lubuntu` (Lubuntu)
+-   `ubuntu-budgie` (Ubuntu Budgie)
+-   `ubuntucinnamon` (Ubuntu Cinnamon)
+-   `ubuntukylin` (Ubuntu Kylin)
+-   `ubuntu-mate` (Ubuntu MATE)
+-   `ubuntu-server` (Ubuntu Server)
+-   `ubuntustudio` (Ubuntu Studio)
+-   `ubuntu` (Ubuntu)
+-   `ubuntu-unity` (Ubuntu Unity)
+-   `xubuntu` (Xubuntu)
+
+# Manually create Linux guests 🐧
+
+You can also download a Linux image and manually create a VM configuration.
+
+-   Download a .iso image of a Linux distribution
+-   Create a VM configuration file; for example `my-custom-linux.conf`
+
+``` shell
+guest_os="linux"
+disk_img="my-custom-linux/disk.qcow2"
+iso="my-custom-linux/my-custom-linux.iso"
+```
+
+-   Use `quickemu` to start the virtual machine:
+
+``` shell
+quickemu --vm my-custom-linux.conf
+```
+
+-   Complete the installation as normal.
+-   Post-install:
+    -   Install the SPICE agent (`spice-vdagent`) in the guest to enable
+        copy/paste and USB redirection.
+    -   Install the SPICE WebDAV agent (`spice-webdavd`) in the guest to
+        enable file sharing.
\ No newline at end of file