diff --git a/README.md b/README.md index c8f5334..95cd4a0 100644 --- a/README.md +++ b/README.md @@ -31,10 +31,8 @@ comprehensive support for macOS and Windows**. * **macOS** High Sierra, Mojave, Catalina and Big Sur * **Windows** 8.1, 10 and 11 including TPM 2.0 * [Ubuntu](https://ubuntu.com/desktop) and all the **[official Ubuntu flavours](https://ubuntu.com/download/flavours)** - * [elementary OS](https://elementary.io/) (only with SPICE) - * [Fedora](https://getfedora.org/) & openSUSE ([Leap](https://get.opensuse.org/leap/), [Tumbleweed](https://get.opensuse.org/tumbleweed/),[MicroOS](https://microos.opensuse.org/)) - * [Linux Mint](https://linuxmint.com/) (Cinnamon, MATE, and XFCE) - * [Pop!_OS](https://pop.system76.com/) (only with SPICE) + * [Fedora](https://getfedora.org/) & openSUSE ([Leap](https://get.opensuse.org/leap/), [Tumbleweed](https://get.opensuse.org/tumbleweed/), [MicroOS](https://microos.opensuse.org/)) + * [Linux Mint](https://linuxmint.com/) (Cinnamon, MATE, and XFCE), [elementary OS](https://elementary.io/), [Pop!_OS](https://pop.system76.com/) * Full SPICE support including host/guest clipboard sharing * VirtIO-webdavd file sharing for Linux and Windows guests * VirtIO-9p file sharing for Linux and macOS guests @@ -85,7 +83,8 @@ See this (old) video where I explain some of my motivations for creating Quickem ## Ubuntu Quickemu is available from a PPA for Ubuntu users. The Quickemu PPA also -includes a back port of QEMU 6.0.0 for 20.04 (Focal) and 21.04 (Hirsute). +includes a back port of QEMU 6.0.0 for 20.04 (Focal) and 21.04 (Hirsute). To +install Quickemu and all the dependencies run the following in a terminal: ```bash sudo apt-add-repository ppa:flexiondotorg/quickemu @@ -99,6 +98,8 @@ git clone --depth=1 https://github.com/wimpysworld/quickemu cd quickemu ``` +Now install all the **Requirements** documented above. + # Usage ## Graphical User Interfaces @@ -110,7 +111,7 @@ While `quickemu` and `quickget` are designed for the terminal, graphical user in ## Ubuntu Guest -`quickget` will automatically download an Ubuntu release and also create the +`quickget` will automatically download an Ubuntu release and create the virtual machine configuration. ```bash @@ -151,7 +152,19 @@ preferred flavour. * `ubuntu-studio` * `xubuntu` -## Linux Guest +## Other Linux Guests + +`quickget` also supports: + + * `elementary` + * `fedora` + * `linuxmint-cinnamon` + * `linuxmint-mate` + * `linuxmint-xfce` + * `opensuse` + * `popos` + +Or you can 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 `debian-bullseye.conf` @@ -290,75 +303,15 @@ tpm="on" * `fixed_iso=` specifies the ISO image that provides VirtIO drivers. * `tpm="on"` instructs `quickemu` to create a software emulated TPM device using `swtpm`. -## elementary OS Guest - -`quickemu` supports elementary OS, but only installs using SPICE. - -```bash -quickget elementary 6_0 -quickemu --vm elemenrary-6_0.conf --display spice -``` - ## FreeBSD Guest -`quickemu` supports FreeBSD production releases. FreeBSD support is maintained by ``. +`quickemu` supports FreeBSD production releases. ```bash quickget freebsd 13_0 quickemu --vm freebsd-13_0.conf ``` -## Fedora Guest - -`quickemu` supports Fedora releases. - -```bash -quickget fedora 34 -quickemu --vm fedora-34.conf -``` - -## linuxmint Guest - -`quickemu` supports linuxmint releases. - -```bash -quickget linuxmint mate-20_2 -quickemu --vm linuxmint-mate-20.2.conf -``` - -## openSUSE Guest - -`quickemu` supports openSUSE Leap, Tumbleweed and MicroOS. - -For the installation to complete properly, on the "Installation Settings" screen, -you need to disable the "Update NVRAM" option. - -On that same screen, you may also want to enable SSH, and open the SSH port. - -```bash -quickget opensuse 15_3 -quickemu --vm opensuse-15_3.conf -``` - -```bash -quickget opensuse tumbleweed -quickemu --vm opensuse-tumbleweed -``` - -```bash -quickget opensuse microos -quickemu --vm opensuse-microos -``` - -## Pop!_OS Guest - -`quickemu` supports Pop!_OS 21.04, but only installs with SPICE. - -```bash -quickget popos 21_04 -quickemu --vm popos-21_04.conf --display spice -``` - # SPICE The following features are available while using the SPICE protocol: